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REVIEW - FILE FINDER 


A pointer-driven file-seeker takes Bryan Davies hunting. 
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Blank pages! ... QL clock ... UnConquerered ... Newsagents ... Machine 
Ancient history ... Damped off ... Lost files. 
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International QL ... QL 2000 Falkenburg ... Qbits ... EEC have Philips 
Screen Dazzler ... Canadian Club. 
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Simon Goodwin continues with part two of Revive, the file retriever. 
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Henry Orlowski with the second part of his useful Easel series. 


TROUBLESHOOTER 


Bryan Davies immerses himself in readers’ letters, 


THE NEW USER GUIDE - part 23 
The Keyword Index from PRINT to PROCEDUR 
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MACHINE CODE FOR BEGINNERS - PART 1 


This time, Alan Bridewell starts right at the bottom. 


DIY TOOLKIT 


Simon Goodwin continues with part 2 of Flexynet 


The long and the long of it - lan Bruntlett introduces the QJump 
start of a long conversation. 
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Yet more on Qpac2 ... Archive statistics ... games! ... 
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Bryan Davies 
tries a Pointer 
Interface-driven 
File Hunter from 
a major supplier. 


INFORMATION 
Program: File Finder 
Price: £19 

Supplier: Software87, 33 
Savermnake Road, London 
NW 2JU. 


oftware 87 has taken 
on the selling in the 
UK of several 
programs developed 
in Germany, and 
distributed there by Jochen 
Merz. From the samples sent to 
QL World, it can be taken that 
these programs meet a decent 
standard of presentation. They 
each have good, well-printed 
A5-size instruction booklets, and 
the instructions themselves are 
generally clear and sufficient 
The programs all have in 
common the QJump Pointer 
Interface, which is as would be 
expected, bearing in mind 
Jochen’s obvious enthusiasm 
for Tony Tebby’s graphical 
interface for the QL A mouse is 
not essential, but does make 
use of the program easier (for 
the novice, at least). Alternative 
key combinations are available 
for some functions and they 
make operation faster and 
simpler. 
As noted in previous 
reviews, prior knowledge 
of the workings of the 
Pointer Interface is 
always helpful when 
getting started with a 
new program that utilises 
it, and this certainly 
applies with File Finder. 
There is a brief section in 
the instructions devoted 
to explaining the PE to 
those who are new to it, 
but the notes do no 
more than give some 
idea of what keys to hit 
to get action. The 
instructions are spread 
over a total of eight 
pages, most of them 
consisting largely of 
“white space”, There is 
really not a lot to explain, 
however, as the sole 
function of the program 
is to locate “lost” files. 


Introduction 


User instructions generally 
start with an exhortation to make 
a back-up copy of the program, 
but the subject does not get a 
mention in the FiFi instructions. 
The program writer, Wolfgang 
Lenerz, clearly feels he should 
not insult users by telling them 
what they already (should) know. 
He starts straight off with a short 
and adequate statement of what 
the program is for - “HiFi is a 
retriever... It will search for, and 
retrieve, all files containing one 
or several strings (up to three). 
These strings are combinable.” 
The program disk supplied for 
review contained duplicate sets 
of files, and had German, French 
and English versions. A working 
copy can be made in the usual 
fashion, with the COPY or 
WCOPY commana, or similar. 

The program is started with 
the EXEC (or equivalent) 
command, and can be activated 
from a Hotkey. Leastways, that is 
what the instructions state. {n 
fact, there is a boot file which 
loads extensions and then tres 
to EXEC the file Fifi_exe. 
Unfortunately, there was no file 
of this name on the review disk. 


The impression given was that 
you are left to figure out that the 
_exe has been missed off the 
program file; the version English 
users will want has _English 
tagged on the end, not _exe. 
French users face the equivalent 
errors. It may be that the 
program disk on which the 
review was based differed from 
what will be supplied to users in 
the U.K, as there is no obvious 
reason to sell a multi-lingual 
version here. Once the boot file 
was sorted out, the program 
started quickly and displayed 
the screen shown in the first 
illustration. 

In the usual PE fashion, the 
pointer - a cross in the case of 
FIFi - can be moved by cursor 
keys or mouse to the desired 
screen area. Once there, the 
function is marked or activated, 
or a text box made active, by 
pressing the Space Bar or Enter 
key, aS appropriate. Where a 
letter is underlined, that letter 
can be keyed to mark/activate 
the corresponding function; this 
is the fastest way of working. 
Instructions are not really 
necessary when the opening 
screen is displayed; you specify 
the drive (and directory if 


File Finder 


applicable), the text string or 
strings to be searched for, and 
the conditions to be imposed an 
the search{es), then move the 
pointer to OK and press Space 
or Enter (as usual, it is 
acceptable in some 
circumstances to press either, 
but sometimes only one), 


Speed search 


Speed is naturally important in 
a search operation and there 
does not seem to be any 
problem here. On a Gold Card 
JS-system, a search for files 
containing three individual 
words, one with case being 
significant, took just a few 
seconds on a double-density 
disk with about a dozen files on 
it, and all similar searches tried 
produced results within the 
same space of time. Making life 
more difficult for the program, a 
search for a file which was a 
page created with Professional 
Publisher {not basically a text 
file) containing three strings of 
alphabetic characters, that was, 
one of several hundred on a 
Miracle 40 MB hard disk drive, 
resulted in nothing being found, 
even though the strings were 
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known to exist. 
Guessing at the reason 
for this, there might be 
a limit to how many 
files FiFi would search, 
and the root directory 
of the hard disk 
perhaps had far more 
files than this limit; 
altematively, sub- 
directory names could 
be giving it trouble. The 
results of a search are 
displayed in a window 
which opens up below 
the main search 
window; the full 
directory and file name 
are shown for each file 
which matches the 
search criteria (see the 
second illustration). 

One disconcerting 
thing was the 
behaviour when 
nothing matching the 
search criteria was 
found. There did not appear to 
be any problem with floppy disk 
searches, and the program 
displayed the word “nothing” 
quite quickly, but “Nothing” was 
what happened in some hard 
disk searches. As noted in the 
previous paragraph, the program 
appeared to stumble when 
confronted with a large number 
of files. {t happily found files in 
sub-directories containing a few 
dozen files, and also found file 
names in the wellfilled root 
directory, but it did not find any 
of the files in the root directory of 
the hard disk when asked to 
locate them by text strings. The 
screen showed no change from 
when the search was initiated 
and you were left wondering 
whether or not the large number 
of files was making the job a 
long one. The situation was not 
helped by the lack of an activity 
indicator on the Miracle hard 
drive. The pointer disappeared, 
but Ctrl-C was still active. It was 
sometimes possible to switch 
back to SuperBasic, but FiFi 
itself appeared to be dead. In 
fact, on some occasions, the FiFi 
screen disappeared, or the QL 
reset when Ctr-C was keyed. 


Discrimination 


There would be nothing 
particularly interesting about a 
program which looked for 
specified strings in every file on 
a device without discriminating 
between one file type and 
another. Fifi provides two very 
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useful options - Text and 
Names. Selecting Text before 
OK causes the program to 
exclude executable files from its 
search. Selecting Names first 
causes it to search only file 
names, not the files themselves. 
Both selections speed-up 
searches, in proportion to the 
ratio of executable to text files on 
the searched medium. 

The search conditions are 
fairly obvious, Case, And, Not 
and Or being standard terms 
users are likely to have come 
across often before. However, 
the Or deserves comment. It is 
not an Exclusive Or, that is, 
specifying that a file should 
contain one string Or another 
means that it is acceptable for 
either string - or both of them - 
to appear in a file. The Not 
indicates that a string should not 
be found in a file. Strings and 
conditions are treated in 
sequence. You must insert 
String 1 if you want to insert 
String 2, and likewise with String 
3. Returning to String 1 and 
modifying it, after setting Strings 
2 and 3, will cause all strings to 
be deleted, the assumption 
being that the user wants to start 
the insertion process over again. 
The conditions apply individually 
to the three strings; you could 
select, for instance, one Not one 
Or and one And, or three Nots. 


Directories 


Directories are not something 
which concem most users, but 
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they are very important to the 
hard disk user, and can also 
matter to Gold Card users with 
HD or ED drives, Pressing Enter 
when the directary box {to the 
right of F2 in the first illustration) 
has been highlighted by the 
pointer brings up a dialogue box 
listing available devices and 
directories, as shown in the 
second illustration. Initially, the 
directories listed are ones which 
are unlikely to correspond to the 
users own names, but they can 
be configured. Using the 
Directory function brought up 
the confusion of the supplied 
set-up again, as the text in the 
box was German! 

It is desirable to be able to 
view a file which has been 
found in the search, and FiFi 
provides this facility. Moving 
the pointer to any of the files 
on the “founa” list, and then 
pressing Space causes the file 
name to be inserted into the 
Hotkey buffer and also 
selected; pressing Enter 
causes the location of the last 
search string in the highlighted 
file to be displayed. The 
window displaying the chosen 
file has << and >> icons, and 
moving the pointer to these 
and pressing Enter causes the 
previous or next, selected file 
to be displayed (keying the 
underlined < or > did not have 
any visible effect, howeven), 
Files have to be selected by 
moving the pointer to them 
individually and pressing 
Space, before the 


forwards/backwards function is 
usable with them. 

Configuration for one's own 
system set-up is accomplished 
with the QJump Config routine. 
Making changes to run the 
program from hard disk was 
straightforward, although it 
involved several files. The 
Directory window still came up 
with flp1_ as the default device 
afterwards, despite wint_ 
being inserted everywhere 
possible, and there was no 
evident way to alter this. Up to 
eight directories can be 
specified, as shown in the 
second illustration. 


Conclusion 


There were several detail 
faults in the review copy which 
needed fixing, but overall 
operation of FiFi was good, the 
speed (with Gold Card) being 
particularly appreciated. A file 
finder will be a desirable 
accessory for many users; this 
one Is speedy, and has sensible 
options. For users already 
having the Pointer Environment, 
this is one more useful tool 
which can easily be added to 
others. It does take rather a lot of 
memory for loading extensions - 
over 50 KB - and this might 
preclude its use on systems with 
little ram to spare. About 30 KB 
of this total would be allocated 
for the same extensions in a 
system already running any 
other PE program, however. 


Open Channel 


Open Channel is where you have the opportunity to voice your opinions in Sinclair QL World. 
Whether you want to ask for help with a technical problem, provide somebody with an 
answer, or just sound off about something which bothers you, write to: Open Channel, The 
Blue Barn, Tew Lane, Wotton, Woodstock, OX7 1HA. 


A blank 


With reference to our 
telephone conversation | am 
retuming my copy of QL Word 
December 1992 to you for 
replacement 

My complaint is that the article 
on pages 10 and 11 which lists 
all the good thing about PCs, 
and the article on pages 38 and 
39 which lists all the reasons 
why | should change my QL for 
a PC, have no place in my 
magazine. 

| enjoy your magazine very 
much and wish all your staff a 
happy new year. 

P R Denscombe 
Redditch 
Worcs 


Here's a reader who knows 
how fo get an editor reaching for 
the tranquillisers*. But it seems 
that Mr Denscombe has 
misread his Contents ... the 
articles on pages 10/11 and 
38/39 of his December QL 
World are about phoning up the 
printers and asking them why 
(oh why?) are there four blank 
pages in this magazine? When 
everyone else's copy has two 
pages of Open Channel and 
two on Desktop Publishing? The 
only answer is to send him one 
thats black and white all over, 
and hope that it will quickly be 
read. 

(*Tea and biscuits, 


The quirky clock described in 
Novembers Troubleshooter is 
not confined to the Sinclair roms, 
as | find my Minerva-equipped 
QL seems to predict that time 
will reverse at around 7 seconds 
after 14 minutes past 3am on 
January 19th, in the year 2029. 
Perhaps we should all make a 
note to avoid benchmark testing 
around this time. 

lf my calculations are correct, 
this is the point at which the Hex 

representation of DATE should 
change from $7FFFFFFF to 


$80000000, and | cannot help 
feeling that such regularity if 
probably highly significant to 
more competent hackers than 
myself 
{t will probably also be 
significant that | own a Tandy 
pocket calculator, which has a 
Hex capability, and this also 
seems to do very silly things at 
exactly the same value. 
L Atkins 
Biggleswade 
Beds 


On the other hand, maybe 
they know something that we 
don't The message is: enjoy the 
early years of the next Millenium, 
as we may have to live through 
them all again backwards. 


Defeated 


| am writing to you because | 
would like you and some of your 
members to help me with 
information on the program PC 
Conqueror, as | cannot save or 
print via my QL serial output 
using a Centronics Parallel 
printer interface when running 
Wordstar. 
| have been your reader now 
for over five years. | have DOS 
3.2 and 3.3 and with Conqueror | 
can run all my programs of IBM 
type, but | can’t save or print, and 
also can't print the screen. 
| have tried to get in touch 
with Digital Precision but have 
had no luck. Also the program 
Xover will not load, and when it 
does the exchange between the 
IBM and the QL will not work as 
it should. 
H Gataaura 
Hounslow 
Middlesex 


Has anyone experienced this 
problem with this combination? 
If traders like Digital Precision 
are not available over holiday 
periods, incidentally, they 
generally become reachable 
soon afterwards, and nearly 
always have answering 
machines. See the section on 


Answering Machines in QL 
Scene. 


Newsagents 


After about a three-year 
absence from the QL 
community due to events 
beyond my control, | have just 
now managed to track down 
your magazine via my local 
Newsforce paper shop, who, it 
must be said, managed to get 
hold of the magazine very 
quickly within one week of my 
initial order, which is excellent | 
now receive a copy on a 
monthly order basis, as 
opposed to taking out a 
subscription which, being as | 
am on state benefit, would make 
a large hole in my income. 

The cover price in all the time 
since | bought my last QL World 
has only gone up by about 25p. 
Other magazines for certain 
Sinclair products that | get have 
gone up from £1.25 to £2.50, an 
increase of 100%, or five times 
the rate of QL World, and all you 
get is a duff covertape with 
programs no-one really wants. 

The last issue | bought, from 
WH Smiths, was May 1989, the 
issue that was the last to be 
stocked on general magazine 
Stalls, | believe. | have since tried 
to find out if the Microdrive 
Exchange is still in operation, 
but it isn’t, is it? Pity, it would be 
great if | and other ‘new’ readers 
could have the chance to 
sample programs of years and 
issues gone by. 

Is there a chance that you 
may introduce this or a similar 
feature (like a public domain 
selection list, etc.) again into your 
otherwise excellent magazine? 

| know budgets may be on 
the tight side, whose itsn't? But 
£2 per disk would be 
acceptable to most users | think, 
and you'd be a supplier to be 
trusted. (The magazines referred 
to above do this to a limited 
degree, but the software is 
commercial, not public domain.) 

This is the first letter | have 


ever sent to any magazine, so, if 
it doesn't make it, I'll understand 


and try again! 
Keep up the valiant fight! 
Chris Dalby 
Bradford 
W Yorkshire 


And a very sensible letter it is 
too. | suppose being away for 
three years has provided a new 
perspective. There were certainly 
copies of QL World in selected 
newsagents’ (as the trade likes 
to say} well after May 1989, but it 
has been hard to find ‘off the 
shelf copies for many years and 
moreso since the recession 
started. However Arcwind deals 
directly with a lot of smal! outlets, 
so it is very viable to order 
copies from a helpful local 
newsagent Back issues, 
unfortunately, are only available 
from May/June 1992. 

Microdrive Exchange used to 
provide a royalty for 
programmers commensurate 
with the effort of producing a 
good program, but that 
arrangement broke down a long 
time ago with a falling market 
rising costs, problems with 
disinbutors, shortage of mavs - 
you name it | kept it going for a 
while on a value-added basis for 
readers, but it emerged that 
sales were erratic and 
programmers were not receiving 
royalites (quite apart from those 
lost when Focus went down), so 
! called a halt | discuss it with 
people from time to time, but ! 
wont even try to lake if up again 
until there is a sizeable clear 
space in other ongoing 
administrative challenges. The 
possibility of doing something 
combined with Public Domain 
offers is not a million miles from 
my mind, however. 


| wrote to Open Channet in 
August suggesting that at least 
one article on Machine Code for 
complete beginners would 
probably be welcome to many 
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like myself, who do not have the 
least idea how to start. 

| took Ms. Armstrong's 
suggestion | should have a go 
without necessarily 
understanding everything. | 
purchased a copy of the 
Metacomo QL Assembler 
Development Kit (second hand, of 
course) and decided to have a try. 

My first attempt was made 
with Listing One from Mr Mellors 
Font Utilisation article in the 
October QL World. The 
assembler came out with a list 
of aroud 40 errors! Careful 
checking revealed that four of 
them were typing errors, but | 
could discover no more 
mistakes of my own. 

In sheer desperation | started 
guessing, and - what do you 
know? - eliminating $$ from after 
the operands in lines 7 and 10 
removed the errors against 
those lines, while assuming that 
the many .1 entries that | had 
placed in the Opcode field 
should have been lower case | 
eliminated the rest! 

But after all this | have 
achieved very little! When | try to 
use the routine with one of the 
Textfonts in the Quanta library 
version of Page Designer. 
nothing happens. 

| had another attempt, this 
time using the Real Time Clock 
Display in Mr Dicken’s book QL 
Advanced User Guide, only to 
come to grief once again. | have 
searched and searched, but can 
find no difference between what 
| have listed and what is printed. 

Please try to persuade one of 
your contirbutors to provide a 
starter article which goes 
through a few codings, line by 
line, explaining what each 
opcode and each operand 
does, and an alphabetical list of 
the standard mnemonics, with 
an explanation of their function 
{or pointers thereto), Words of no 
more than two syllables, please. 

L Atkins 
Biddleswade 
Beds 


Starting this month! 


History lesson 


PLEASE REPEAT AFTER ME; 
THE FIRST CONSIDERATION IN 
PRINTING A SERIOUS 
MAGAZINE IS THE LEGIBILITY 
OF PRINT. The information on 
(the upaginated) page 31 is 
Virtually unreadable without 


oe 


some hard work on the part of 
your faithful subscribers. You 
may recall that | questioned a 
(much less) difficult piece of 
printing in the issue carrying my 
Armada Index. Having read it 
once, | still can't recall what the 
SJPD/QL World competition is 
all about! Please keep your 
designers on a tight rein. 

John Roberts 

Littlehampton 

E Sussex 


Yes John Sir, right away. Don't 
you mean a tight lead? | must 
admit it isnt one of the art 
department's triumphs. | think | 
might run it again. By the way, 
that is the most hideous 
typeface I've ever seen in my life. 
although (unlike many hard-up 
users) thanks for using a ribbon 
which isnt virtually transparent 


Washable 


| am saving a stamp by 

enclosing my return for the 
readers’ survey (with another 
letter). You will notice that it is 
somewhat battle-worn. When the 
mag arrived, its envelope 
contained as much water as 
magazine. One unconsidered 
benefit of the paper you use 
nowadays is that it is much 
easier to dry out Although | am 
sometimes reminded of a lady | 
once knew who had been a 
Petty Officer (boats) in the WRNS 
during the war, and in her later 
years sailed a very lovely ketch 
around the West Coast Her first 
encounter with a terylene genoa 
prompted the comment that the 
“£@* thing would blow 
overboard. Modem magazines 
are similarly slippery. Very 
difficult to balance on one's 
knee and twiddle a forkful of 
spaghetti at the same time. 

PH Tanner 

Glasgow 


But easy to wash up 
aflerwards. Glossary: genoa: not 
a small rodent; a type of sail: 
ketch: chunky sailing boat with a 
large hold used for fish or 
weekenders, terylene: synthetic 
substance not used for making 
paper. The washable qualities of 
modem magazines are 
appreciated by those who own 
elderly cats. The code in the 
middle of this letter has been 
(you'll be glad to hear accurately 
reproduced. 


Urgent! 


Whenever my files get 
corrupted; say, twice a year, the 
most disastrous and likely event 
is the destruction of the memory 
map at the start of the disk, 
because that involves the loss of 
not one, or two, files, but ten, fifty, 
a hundred or 250 files. Of my 
disks, several have gone that 
way over the past few years, and 
been consigned to a temporary 
graveyard, while | hope for 
something to resurrect them. 
Now, alas, something more 
serious has happened. 

My excellent Extra High Density 
disk-drives supplied by Miracle 
Systems have proved ideal (apart 
from Ferret not working on them) 
until ! found my Disk Adapter (also 
from Miracle) which permits me to 
link up the older Cumana disk 
drives. The Adapter worked, but its 
fit into the Gold Card was not 
particularly firm, and being just 
next to the F5 key, it was easily 
knocked, with unhappy results. 

In my case, apart from the time 
that it simply tumed off the two 
disk drives, on one occasion it 
cleared some of the memory 
map. Now | have a 32M disk, 
which is full of files, including, 
inevitably, some recent ones not 
backed up, but no Memory Map 
to them. 

So, the question is: what 
recovery program will cope with 
a missing Memory Map, 
reconstruct the files listed on it, 


offer more information. 


the clue is in the December issue! 


formatting, etc. 


PE TEN YT? 
Editor’s notebook 


A long article this month: an introduction by lan 
Bruntlett to the much-discussed but often mysterious 
QJump Pointer Environment This is incorporated into 
several modem QL programs - the most well-known of 
which is QPac2, a bundle of QL accessories by Tony 
Tebby. It provides something like a graphic front-end, 
and makes multitasking easier by controlling program 
windows. It uses the keyboard or a mouse, and is not 
expensive. Some people have been put off by its 
apparent complexity, but it is well worth investigating. lan 
will be writing more on Qpac2, and Dilwyn Jones can 


I'm running the Competition again - but don't forget 


Don't forget - if you have an idea or program you 
would like to write for QL World, write and tell the Editor, 
who will supply comments and further information on 


One of the QL suppliers (who rarely uses an 
answering machine) has asked me to say a few words 
about telephone answering machines (non-use of, 
enquiriers and customers by). But | phoned him for 
advice and he was out .. maybe next month! 


and then write a new map? 
Surely it can’t be that difficult for 
the machine-code wizards who 
create programs for reading 
tracks and the headers that 
constitute the maps. How about 
it? PS It would be good to have 
Ferret working again to find 
urgently-sought strings, too. 
John Roberts 
Littlehampton 
E Sussex 


Oh dear You seem to be 
having serious problems with 
readability everywhere this month. 
Try: Simon Goodwin's Revive 
(SuperBasic in Action, this month 
and last month): various public 
domain routines from Qubbesott 
or CGH Senices; Media Manager 
SE from Digital Precision (that's 
the high-tech expensive option): in 
any case, talk to Ron, Richard or 
Freddie (or all three) before you 
make a purchase, to see if their 
programs will deal with your 
situation. If you can find a copy of 
Disk Doctor, which used to be 
popular, try that 

The horrible truth ts that you are 
storing up trouble for yourself by 
using a system of mixed type and 
age. Stuart at Miracle says: call 
him about the Adapter connector 
- they havent had this problem 
before, and its a standard push-in 
connector widely used in industry 
(we have never had a complaint 
about a Disk Adapter falling out or 
getting knocked) 


EEC MONITORS 


Astop press fast month 
announced that Bill Richardson had 
not been able to obtain top-up 
stocks of the popular Goldstar QL 
monitors. 

The good news, however, is that he 
has a good stock of the Philips 
CMO073 monitors, which are excellent 
for the QL The monitors are good- 
quality, tested second-user machines, 
at a competitive price with a 3-month 
warranty. 

The Philips CM073 14-in EGA 
colour monitor has an excellent 
specification, is very controllable, has 
an 85-character capability, and 
extemally accessible controls for 
width, height and centering. It has a 
green/amber text-mode switch, and a 
dedicated QL monitor lead is 
provided with the purchase. 

The monitors cost £145, inclusive 
of VAT, plus £9 for packing and 
delivery charges. 

Contact W N Williamson (EEC), 
18-21 Misbourne House, Chiltern 
Hill, Chalfont St. Peter SL9 QUE. Tel. 
0753 888866. 


International QL Meeting 


The Dutch QL User group Sin_QL Air, and the German QL_User 
Club SQLUC are proud to announce the 1993 Intemational QL 
Meeting on Saturday 27 February. The meeting, the third of its kind, will 
be held as before at the St. Joris College, Roosterlaan 296, 
Eindhoven, in Southem Holland, from 10am to 5pm. Set-up is 
available for groups and suppliers on the previous evening (Friday), but 
people are asked to keep in touch with the organisers for an 
appointment Entrance will cost 3.50 Dutch Flrins (including a free 
drink), and a two-meter table for exhibitors costs 15 Dutch Fiorins. 

The meeting is dedicated to the QL and Qdos (including Minerva 
and SMS2). People will be able to give and get information (although 
the only person we know who actually becomes information is Freddie 
Vachha when the spirit is on him), show off private and commercial 
projects, meet other QL users and have a good time. Now that EC 
border tariffs have been reduced, a little shopping might be in order, as 
well, for those who like Dutch food and drink No information is 
available at the moment about which dealers will be there. (You can 
always phone anyone you wish to see, and ask them) 

Further information can be obtained from the organisers: In the 
Netherlands, JJ van der Molengraaf, Mullerweg 17, 5624 JC 
Eindhoven, Holland, tel. (from UK) 010 31 40 442309 or Marco 
Holmer, J P Coenstraat 51 bis, 3531 EN Utrecht, Holland, Tel. 010 
31 30 948673: in Germany, Franz Herrmann, Talstrasse 21 W-5460 
Ockenfels, Germany. Tel. 010 49 2644 1855, weekends only. 
Bulletin Board: QLAT-BBS, 010 31 30 962265 (v21Vv23,v22(bis),v23) 
2:283/508, 24 hours. A map and information about hotels and 
boarding houses is also available (although advice may be needed by 
those who don't know Dutch). 


Leeds Quanta | MC Erratum 


Canadian Star QL Drivers 
Club Moondust! 
The Toronto Timex Sinclair News has gone out from 


Users Club has been in touch 
with a copy of their bi-monthly 
bulletin Sinc-Link, Big Fall 1992 
Issue. Named as the largest 
computer-club newsletter in 
North America by a survey in a 
US magazine, Sinc-Link covers 
all Sinclair computers (2X81, 
2068, etc.) but has a fair amount 
of QL coverage. The newslatter 
has 36 pages in US format, 
stapled at one corner. 

Material clearly comes from 
many different authors and 
sources - some is a bit filled-in, 
but itis all clearly readable 
except a rather “dotty" section on 
the ZX81 which might give 
some people problems - | 
certainly found it hard going. 
Sinc-Link prides itself on not 
overdoing its listings section, but 
generally providing information. 
Several letters are reproduced, 
including the information from 
Car Delhez about his Sinclair 
emulators (which QL World 
readers can find on page 32 of 
the December issue). Former 
Quanta editor Alan Pywell writes 
“SuperBasic Ramblings”. 

Membership of the club is 
$20 a year. The QL contact is 
Hugh Howie, 586 Oneida 
Drive, Burlington, Ontario L7T 
3V3, Canada. 


& 


popular printer purveyors Star 
Micronics UK that ‘Sinclair users’ 
now have easy access to printer 
drivers for all Stars models, 

What, we asked their publicity 
department, was a Sinclair User? 
They said they'd get back to us 
on that one. 

Eventually we spoke to Star's 
Technical Hotline. Alas, it seems 
that there has been a mistake. 
“We haven't had anything like 
this,” the Technical Hotline told 
us. Star's Hotline office - better 
informed than many computer 
dealers, their printer-driver 
adviser knew at once about the 
QL and was as surprised as we 
were at the news - will tell us if 2 
any such thing does indeed 
amive. But he expressed his 
doubts. David Taylor in 
marketing checked up and told 
us: “Its a mistake. Thank you for 
getting in touch with us” 

So it looks as though the QL 
and its Sinclair cousins are 
simply the victim of the eager 
media-world's tendency to 
mistake the august name of 
‘Sinclair for just another brand of 
PC. Shame. But we were 
impressed by the Hotline and 
Marketing Department's quick 
response when we were on the 
line. 


Eleanor Kirkpatnck is co- 
ordinating a new Quanta group in 
Leeds/Brandford area. The next 
meeting should be Wednesday 31 
March from 7 to 9 pm at John 


Parkin’s “QL Classroom’, St Edmund 


Capion School, Rhodesway, 
Bradford. Send Eleanor an SAE for 
details and a map at: 37 Gledhow 
Wood Avenue, Leeds LS38 1NY. 


As well as improved versions of 
Listings 5 and 6 from Systematic 
Machine Code part 10, we also 
have corrected versions of the 
KEYROW and SOUND routines 
from the same episode, Write to the 
Editor if you want copies. Please 
note that the same routines in the 
whole-program listings are from a 
different file and work as printed. 


Dillwyn Dazziles 


New from Dilwyn Jones is 
Screen Dazzler, a screen-saver 
program which produces some 
form of animation to save screen 
phosphor burn-in if no key is 
pressed for a given period of 
time. This requires at least 384K 
of memory on the QL Users can 
write their own animation 
routines if they have a compiler, 
using the Screen Dazzler 
manual as a guide. Some 
sample animations are on the 
disk. The program is on 3.5in or 
5.25 in disks, but not mdv, and 
costs £15. 

For the puzzled: a Screen 
Saver program places a moving 
picture or pattem on the screen 
when the computer is running 
but not in use, to prevent 
accidental bum-out of monitor 
phosphors if it is left running for 
long periods (see Open 
Channel, Fishhhhh, last month), 
and is not to be confused with a 


Save Screen or Screen Save 
routine, which saves the 
contents of a screen to a file for 
printing or transfer. 

Dilwyn writes: “If people who 
want fishtanks are prepared to 
produce the animation program 
themselves, Screen Dazzler 
could activate them as screen 
savers. What is needed is a 
Basic compiler, and a sprite 
package such as Digital 
Precision’s Super Sprite 
Generator. Write the program, 
get it to work, and finally add it 
ot the list of programs which 
can be activated by a program 
such as Screen Dazzler." 

Contact Dilwyn Jones 
Computing at 41 Bro Emrys, 
Tal-y-bont, Bangor, Gwynedd, 
LL57 3YT, UK. Tel. 0248 
354023. Please avoid calling 


«very early or late, as the phone 


still ngs even when the 
answering machine is on! 
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QL Packaging for the year 2000 


Jurgen Falkenburg Computer 
Technik are offering a 
professional packaging job on 
the QL, known as the QL 2000. 

Falkenburg also manufacture 
some expansion add-ons (see 
below), but the QL 2000 is 
essentially a re-housing of 
existing QL systems ina 
modern tower case, with room 
for expansions and connections 
for a Falkenburg’s own, popular 
QL-Keyboard-90 outboard 
keyboard. 

Users can send their existing 
QL rigs to Falkenburg to be built 
up, or buy a do-it-yourself 
package. The custom-built 
option costs from DM 699 
(about £280) and the DIY option 
costs DM 399 (£160) inclusive of 
EC VAT. Fitting of the DIY option 
requires “only some screwing- 
and soldering-work’ following 
the installation manual which is 
ncluded. 

The QL 2000 package has 
been developed with users of 
the Gold Card, Keyboard 90, 
and/or the Falkenburg QL-HDD- 
card hard disk interface, but 
other peripherals such as the 
QBoard, Trump Card and 
Miracle disk drives can be used; 
and, unlike many upgrades, the 
old QL microdrives can be 
assembled, two together, in one 
of the two 5.25-in disk slots 
provided. 

The QL 2000 is compact, with 
a footprint of Sin wide by 17in 
deep, and a height of 13 inches. 
The front panel has room for two 
35-in floppy or hard disk drives, 
two 5.25-in floppy or hard drives, 
one 3.5in hard disk internal 
socket, plus room for a further 5- 
in or 5.25-in internal hard disk 
socket. 

The intemal space is enough 
for the regular QL circuit board, 
plus up to five QL peripheral 
cards. Falkenburg’s own 
expansion cards are designed 


to be mounted vertically or 
horizontally depending on what 
type of case they are being 
installed into; in the QL 2000 
case, they mount vertically. 

On the back of the case are 
110/120-volt or 220-240-valt AC, 
monitor, serial port, joystick, 
network and keyboard 
connectors. The keyboard 
connector is, as stated, provided 
for the QL-Keyboard-99, but 
fitting a different keyboard 
normally only requires changing 
the socket type. 

Also available is a “powerful 
200-watt power supply with a 
noiseless blower’. 

The already-established QL- 
HODD-Card is a hard-disk 
expansion board suitable for 
expanded and unexpanded 
QLs, designed with considerable 
versatility for use with “any MFM- 
resp. RLL hard disk with up to 
416 MB capacity’. It supports the 
filing system 2 used by the Gold 
Card, or Level-2 updated Trump 
cards and QBoards with 
subdirectories. Two hard disks 
can be plugged into the 
interface. 

Users interested in the QL- 
HDD-Card are advised to get in 
touch with Falkenburg with 
information about their systems, 
as prices etc. vary with the type 
of disk drive to be driven, case 
configuration, etc. 

In the UK, WN Richardson & 
Co. (EEC) are acting as 
Falkenburg’s agents. This is 
particularly useful for users who 
don’t want to send hardware 
back and forth to the continent 
Both companies are a source of 
information on the QL 2000 
system and other Falkenburg 
upgrades. 

Jurgen Falkenburg 
Computer Technik, Thanweg 
36, D-7539 Ersingen, Germany. 
Tel. (from UK) 010 49 7231 
81058 (voice or fax), 
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QBits and 
Pieces 


QBits of Willingham, 
Cambridge, a small dealership 
that has been trading away 
quietly for the last three years, is 
selling a range of software under 
the QBits Budget Software label 
at £5 plus 50p post and 
packing per program. 

Titles in this range include 
Conundrum, where you work 
against the clock to build up a 
word chosen by the computer, 
using either jumbled letters or 
clues. This currently includes 
free of charge a file editor called 
WordGen to enable you to 
generate your own word-lists for 
the game; Early Learn, two 
simple educational games 
(SpeliBear and Clocks & Tables) 
to help children master the 
basics of spelling, tables and 
time-telling (analogue and 
digital); Sam, a two part game 
(Storeman Sam and Warehouse 
Sam) with an educational basis, 
in which you unload and load 
lorries in a depot, aiming to 
make profits from orders; 
FTidy_128, a simple file-handler 
displaying up to 64 file names, 
to copy, delete, print, rename 
and view files easily. This 
package currently includes a 
free game, APM_Sweeper, and 
finally, QL-Engine, a detailed 
animation of forty screens 
showing the internal combustion 
engine in a four-stroke, four- 
cylinder combustion cycle, 
written by an experienced 


QL Scen 


engineer. QL-Engine needs a 
Gold Card to run because of the 
detailed graphics. 

QBits also handles a useful 
list of second-user QL and disk- 
drive hardware, software, books 
and backissues of QL World 
and Quanta. 

QBits are at 29 Silver Street, 
Willingham, Cambs. CB4 5LF. 
Tel. 0954-60288. Phone or write 
for a current list or information. 


All Formats Fair Diary 


Coming dates for the All Formats Computer Fair are: 

Feb 20: Haydock Park Racecourse, M6 junction 23; Feb 21 
Scotland City Hall, Candleriggs, Glasgow; 27 Hemel Hempstead 
Dacorum Pavilion, The Marlowes Centre; 28 Feb westem Brunel 
Centre, Templemeads Station, Bristol. Mar 7 North University Sports 
Centre, Calverley Rd. Leeds Mar 20 London Sandown Park Mar 21 
West Midlands National Motorcyle Mar 27 North West Haydock Park 
Racecourse, junction 23 M6 Motorway 3 Apr Edinburgh Appleton 
Tower, George Square 4 Apr Glasgow City Hall, Candleriggs, 
Glasgow Apr Nottingham University, Jesse Boot Centre Apr 18 West 
Midland National Motocycle Museum, junction 6 M42 Apr 24 
London Sandown Park, Esher, Surrey junctions 9/10 M25 Apr 25 
Bristol Brunel Centre, Templemeads Station. 

Check with any particular supplier that you are hoping to see 
whether they will be at a particular Fair. if you have far to travel phone 
All Formats 0608 663820 to check arrangements haven't changed. 
Many QL suppliers only attend the Glasgow and London fairs with 
any regularity. In London the Hammersmith venue is preferred. 

Tickets are £4, but attendees can get up to 50 £1-off vouchers if 
they send an SAE to the organisers at: Maple Leaf, Stretton-on- 
Fosse, Moreton-in March, Gloucestershire GL56 9QX. (Only one 
voucher can be used per ticket, of course) 


In part two of 
Revive, Simon 
Goodwin 
addresses error 
trapping and 
high-density disk 
formats. 


evive is a 

SuperBasic program 

to recover files from 

damaged disks. 

Modem floppies are 
very reliable, but you should still 
keep backup copies of all your 
files. Itis always easier to 
recover a program from a 
backup than from a damaged 
disk. 

That said, most of us have 
ended up at some time with 
valuable data on a disk with an 
unreadable directory. That's 
when Revive comes to the 
rescue. 

The program lines presented 
this month fit into gaps in last 
month's listing. They perform 
Turbo error trapping and allow 
Revive to scan disks and 
recover files in blocks. | also 
discuss the special features of 
the High Density 1.44 megabyte 
and Extra High Density 3.2 
megabyte disk formats used on 
the Miracle Systems Gold Card. 

By default Revive expects 
double density disks in drive 1, 
but you can change to another 
drive or density by typing the 
(QFLP direct sector access name 
in full, for example; FLP2_*D2D, 
FLP1_*D2H or FLP3_*D4E {lucky 
you!) when the program asks for 
a good disk Altematively, edit 
line 420 to change the default 

The program is written for 
double density disks of 180 to 
756K capacity, but it can easily 
be adapted to repair Gold Card 
high density disks. These have 
“QLS5B’ at the start of the first 
sector, rather than “QL5A", so 
alter line 650 to check for "QLS" 
in SECTORS(1 TO 3). 


Gold formats 


1.44 megabyte HD disks use 
512 byte sectors, like double 
density, but pack 18 onto each 
track and side, Files are 
allocated in 1.5K blocks, as 
before, but the disk map is twice 
the original size (2880 bytes, two 


os 


blocks) and there are 960 blocks 
allocated on each disk. 

3.2 megabyte ED disks use 
2K sectors, so the value 512 in 
the program needs to be 
replaced with 2048, at line 420, 
740, 800 and 1670. The directory 
and map take up eight sectors, 
and each block is a single 
sector, so there can be up to 
1598 files on each disk, and a 
full block reports can be more 
than three times as long as the 
double-density equivalent - 
perhaps 200K or more. 

The QL directory holds fixed- 
sized 64 byte records of the 
name, type, size, dataspace and 
dates of each the file. If the 
directory is intact you can read 
these ‘file headers’ with 
OPEN_DIR from Toolkit 2, or 
GetHEAD from DIY Toolkit They 
do not tell you where the file 
appears on the disk - you need 
the mapping table to determine 
that in full - but you can get a 
good idea by scanning the disk. 


The scanner 


A vestigial 64 byte header is 
created at the start of the first 
block when a new file is 
opened; the size and dates are 
unset but the name does 
appear. Revive's SCAN DISK 
option spots likely headers, 
indicating the start of a file and 
its original name. Beware: 
RENAME changes the directory 
entry, but not the name at the 
start of the file! 

The Gold Card formats do not 
use or set this header - my 
investigations with version 2.31 
of the Gold Card find it unset on 
HD disks. On ED disks it 
contains junk from the disk 
buffer - offen old and arbitrary 
directory information. If an ED 
disk is full of 2K files, up to 100K 
might be occupied that way! 

If you're working with the new 
Gold Card formats you can 
leave out lines 1240 to 1330, 
and 1500 to 1560, as these 
handle the double density 
header. You should add one 
line, to make it easier to spot the 


Im A\ctiom 


start of files: 


1345 PRINT #4;"Later: *; 
TIDYS(block$(65 to 114) 


lf this is the beginning of a 
new file, the ‘start’ report line will 
be junk. The new line shows the 
first bytes of the file, which 
should identify text and Basic 
files, and contains the job name 
of most tasks. The ‘start’ report is 
still useful when matching up 
the end of one block with its 
continuation in another - usually 
the next 

| have not (yet!) corrupted a 
high density disk in normal use, 
but | have a friend at West 
Midlands Quanta sub-group 
who will be glad of the re- 
vamped Revive! | have just two 
ED disks, but they've had plenty 
of use over the last few weeks, 
and | have ‘recovered’ a variety 
of files with the modified version 
of Revive, including programs, 
QRAM help and ramdisk code. 

You need the file size (and the 
dataspace, for a task) to recover 
a code file successfully. 
Sometimes the end of the file is 
obvious when you examine the 
recovered blocks in an editor; 
ideally you'd have a WSTAT 
report taken before the disk was 
damaged. 

FORMAT writes strings of zero 
bytes to each virgin sector, and 
Revive can guess the end of 
most files by spotting these. In 
some cases the file may be 
‘fragmented’, which means 
allocated in several chunks. This 
may happen if the file is 
extended after an older file is 
deleted. 


Big blocks 


If a block is readable, Revive 
retums the entire contents, even 
if the last block was not 
completely used by the file. You 
need the exact file length to 
recover a code file, and the 
dataspace for a task, but Psion 
data, text files and program 
source still load with extra bytes 
from the end of the block. 


If you find junk at the end of 
the file, you may need to chop 
the end off using a text editor, or 
the PUT and TRUNCATE 
commands of Toolkit 2 and 
most disk systems. 

Often you can determine the 
end of a task by scanning the 
file with a binary editor like Spy 
or The Editor. QL task lengths 
are always even - if not, EXEC 
will crash! Dataspace must be 
even and positive; you might 
start at 8K and adjust this if you 
get an ‘out of memory’ report 

When a disk's directory is 
intact you can read the size, 
type and dataspace of a file 
quickly with GetHEAD, from DIY 
Toolkit volume H. You can 
change the type or dataspace 
with SetHEAD. If you've time and 
memory to burn, use LBYTES 
and SEXEC. 

The program was written and 
compiled with Turbo, and uses 
a mixture of Turbo Toofkit and 
Toolkit 2 extensions. Now I'll 
explain how you can get it 
working with other Toolkits or 
secret features of the Sinclair 
rom. 

The IMPLICIT% and 
DATA_AREA directives are only 
needed for Turbo compilation, 
and can otherwise be omitted. 
The QLib equivalent of 
IMPLICIT% is DEF_INTEGER. 
Such directives show a compiler 
that a name is only used for 
integer values - whole numbers 
between -32768 and 32767 - 
allowing faster, more concise 
code to be generated. 


Error trapping 


RETRY_HERE statements and 
the WHEN_ERROR .. 
END_WHEN block at the start of 
the second listing implement 
Turbo error trapping. You should 
not enter these unless you 
intend to compile the program 
with Turbo. 

Any error in the compiled task 
causes the code at 
WHEN_ERROR to be executed. 
RETRY sends execution back ta 
the most recent RETRY_HERE 
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point, discarding any local 
variables or retum details 
generated since then. 

RETRY_HERE statements 
appear before all the lines that 
may need to be repeated if an 
error is detected. A ‘blanket’ error 
trap covers other cases, so the 
task should never crash, 
regardless of the circumstances, 
unless error details fill all its 
memory, or something goes 
wrong in the WHEN_ERROR 
block! 

The WHEN ERROR block 
calls ERLIN% to check the 
number of the line where the 
error occured: if it is not one of 
the expected lines it uses 
ERNUM% to find the cause and 
reports suitably. If you have a JS 
or later rom you could use 
REPORT to print the 
corresponding Qdos message, 
and ERNUM and ERUN to 
pinpoint the cause. 

Minerva users could employ 
their interpreters WHEN ERROR 
facility to trap errors. This may 
seem to work on JS or MG roms 
but in practice Sinclair bugs 
mean that some errors are 
ignored or lock the machine, 
even if Toolkit 2 is loaded. 

If an unexpected error OCCUTS, . 
the program closes channels #3 
and #4 and re-starts after 
complaining in window #0. If 
this happens hundreds of times 
you are likely to run out of 
dataspace eventually. RETRY is 
used whenever repeated errors 
are likely; it is preferable 
because it tidies unused local 
variables and RETums, so the 
task loses no memory. 

Line 640 and 1670 use GET 
to position the file pointer and 
INPUTS to read the sector. If you 
do not plan to compile the 
program with Supercharge or 
Turbo, you can replace the 
INPUTS with an extra parameter 
for GET: 


640 GET #311 sectorS 


Beware: attempts to read a 
512 byte sector from an ED disk 
lead to a total crash, requiring 
reset to recover. The opposite 
case is more forgiving: Gold 
Card 2.31 reports a drive error 
and retums control to the user, if 
you unplug the cable after 
accidentally trying to read a big 
sector from a DD or HD disk. 

The Turbo Toolkit function 
DEVICE_STATUSA( ,file$) is used 
at line 2080 to check the report 
file name. This returns an error 


code if the file does 
not exist, rather like 
FOPEN IN, or the 
amount of free space 
on the drive 
otherwise. By default 
the report appears in 
a large SCR window, 
but you can send it to 
any device. 

Line 2160 uses 
GET #3\1E7 to wnte 
to the end of an 
existing file, extending 
a report. The large 
parameter winds the 
file pointer to byte 
10,000,001 of the file, 
or the end, which is 
usually sooner, Use 
Turbo Toolkit's 
SET_ POSITION 
instead of GET if you 
want the program to 
work without Toolkit 2. 

CURSOR_ON #0! 
is the Turbo Toolkit 
equivalent of Toolkit 
2’s CURSEN #0, or 
the useful but 
unexpected PAN 
#00115 on Sinclair 
roms. Likewise 
CURSOR _OFF #0 
corresponds to 
CURDIS #0, or PAN 
#00116. 

The STRING% 
function is a 
SuperBasic version of 
the eponymous Turbo 
Toolkit routine. If you 
have Turbo Toolkit 
you do not need to 
enter this function. 
The SELect statement 
avoids temporary 
results outside the 
range -32768 and 
32767; this suits 
Supercharge's fast 
integer code. 


| welcome 
suggestions for future 
articles and 
information in this 
series. The aim is to 
show how useful, 
adaptable programs 
can be written in 
SuperBasic. Write to 
Simon Goodwin, 
SuperBasic in Action, 
QL Word, The Blue 
Bam, Wooton, 
Woodstock, Oxon OX7 
1HA | look forward to 
hearing from you. 


Sinclair/QL World February 1993 


100 REMark KEVIVE - SuperBASIC in Action disk data recovery program - ©SNG 
160 WHEN_ERROR 
170 reason=ERLINé 
180 SELect ON reason 
190 =600 
200 COMPLAIN "This interface does not allow direct access to data." 
210 STOP 
220 =640 : COMPLAIN "Format description is unreadable." 
230 =1090,2190 : COMPLAIN "Please enter first & last block numbers," 
240 =1150,2100,2160 : COMPLAIN "Unable to open " & files 
250 =1670 : read_ok=0 : REMark Set flag for trapper 
260 PRINT #4\"BLOCK " & block_no & " IS UNREADABLE."\\ 
270 REMAINDER 
280 reason=ERNUM 
290 SELect ON reason 
300 == 11 
310 COMPLAIN "Drive full." 
320 w-1,-5,-6,-9,-10,-16,—20 
330 COMPLAIN "Qutput failure (code " & reason & "),." 
340 =REMAINDER 
350 COMPLAIN “Unexpected error " & ERNUM& &" at "& ERLIN@ & "." 
360 END SELect 
370 CLOSE #4 : CLOSE #4 : GO TO 486 : REMark POP? 
380 END SELect 
3390 RETRY 
400 END_WHEN 
410 : 
1030 DEFine PROCedure SCAN_DISK 
1040 HEADING : INK green 
1050 PRINT \* Ready to scan disk - disk blocks are numbered from *; 
1060 PRINT "0 to ";total_blocks-1;"." 
10706 INK white 
1080 RETRY_HERE 
1090 INPUT \"Enter first & last block numbers to be scanned “\first\last 
1100 IF last>=total_ blocks : last=total_blocks-1 
1110 IF first<o : first=«o 
1120 RETRY_HERE 
1130 INPUT \"Enter output device name for report ";file$ 
1140 IF LEN(file$)<3 =: file$="SCR_448x200a32x16" 
1150 OPEN_NEW #4,fileS 
1160 on_screen=file$(1 TO 3)=="scr" : IF on_screen 
1170 CLS #4 ; CURSOR_ON #0! 
1180 PRINT #0;" Press CTRL-F5 to pause, or ESC to quit,” 
1190 END IF 
1200 file$="" : busy=0 
1210 FOR index=first TO last 
220 GET_BLOCK index 
1230 PRINT #47"Block ";index 
1240 IF CODE(block$(1))=0 
1250 REMark It may be a file header: length is < 2°24 
1260 name_length = STRINGt(block$(15 TO 16)) 
1270 IF name_length>=0 AND name_length<=36 
1280 REMark Name seems plausible 
1290 IF CODE(block$(4})=64 
1300 SHOW_HEADER 
1310 END IF 
1320 END IF 
1330 END IP 
1340 PRINT #4:" Start: ";TIDY$(block$(1 TO 50}) 
1350 PRINT #4;" End %; 
1360 IF busy AND block$(block_bytes-9 TO block_bytes)="0000000000" 
1370 PRINT #4;"of file ‘";file$;"‘ inferred at block *;index 
1380 busy=0 
1390 ELSE 
1400 PRINT #4;": “;T1IDY${block${block_bytes-49 TO block_bytes)) 
1410 END IF 
1420 IF on_Sereen 
1430 IF INKEY$(#0,1)="CHRS(27) : EXIT index 
1440 END IF 


1450 END FOR index 


1460 IF on_screen : 
1470 CLOSE #4: 
1480 CLS #0: 


CURSOR_OFF #0 
CLOSE #3 
COMPLAIN "" 


4490 END DEFine 


1510 DEFine PROCedure SHOW_HEADER 
1520 file$=TIDY$(block$(17 TO 16+name_length)) 


1530 PRINT #4;" 


xaee Start of file *"; 


1540 PRINT #4;file$;"* #0" 
1550 busy=1 
1560 END DEFine 


1916 DEFine FuNction TIDY$(text$) 
1920 LOCal index,c 
19306 FOR index=] TO LEN(text$) 


1940 c=CODE({text$( index)}) 
1950 IP c<32 : text${index)="?" 
1960 IF c>top_limit : text$(index)="!" 


1970 END FOR index 
1980 RETurn text$ 
1990 END DEFine 


2010 DEFine PROCedure RECOVER _FILE 


2020 HEADING : 


INK white 


2030 REPeat recovery_loop 


2040 RETRY_HERE 

2050 PRINT \"Enter name of file for recovered data (or enter nothing"; 
2060 INPUT " to restart) “\fileS 

2070 IF file$="" : EXIT recovery_loop 

2080 status=DEVICE_STATUS(1,file$) 

2090 If status=-7 

2100 OPEN_NEW #4,fileS 

2110 ELSE 

2120 IF status<1536 

2130 COMPLAIN "Unable to open ‘"& fileS &"*, error code: "Sstatus 
2140 NEXT recovery_loop 

2150 END IF 

2160 OPEN #4,file$ : GET #4\1E7 

2170 END IF 

2180 RETRY_HERE 

21390 INPUT \"“Enter first & last block numbers"\first,last 
2200 INK green 

2210 PRINT \"Writing to ";files 

2220 FOR index=first TO last 

2230 GET_BLOCK index 

2240 IF index=firet 

2250 IF status=-7 

2260 PRINT #4:block$(65 TO); : NEXT index : EXIT index 
2270 END IF 

2280 END IF 

2290 PRINT #4,blockS; 

2300 END FOR index 

2310 CLOSE #4 

2320 PRINT \file$; 

2330 IF status=-7? : PRINT ” created." : ELSE PRINT “ extended." 
2340 INK white 


2360 END REPeat recovery_loop ; 


CLOSE #3 


2380 END DEFine 


[EEO 


é first thing we need 

to get a feel for in 

Easel is the method of 

putting items into the 

graph. We touched on 
the subject of direct data entry 
last month in part one. With 
Easel newly loaded up, you will 
have the crosswires over ‘Jan’. 
To enter the value 25, simply 
type 25, watch it appear in the 
input line at bottom left hand 
side of display, and then press 
Enter. 

You will now notice that three 
things have happened. First, a 
large bar has appeared in the 
Jan cell. Secondly, the left hand 
scale has expanded from 0 to 
10, to 0 to 25 automatically. This 
is of course to accommodate 
the new value of 25. Thirdly, the 
crosswires have moved one cell 
to the right and now occupy the 
Feb cell. 

Now type in some text This is 
different from entering values, 
but only because you have to 
remember to precede it by the 
double or single quotation 
marks, “ or . These tell Easel to 
expect text to be following. Type 
in your quotation mark and see 
how the input line changes to 
Text, Now type in something 
like This is a piece of text - don't 
type the quote marks again, 
these are only included to make 
you realise which bit it is you're 
supposed to be typing in. You 
don't need closing quote marks. 


Changing text 


Notice how the text you have 
just typed in appears not only in 
the input line at the cursor 
prompt but also at the 
crosswires position in the 
display area. Of course the 
chances are that the text will not 
be in the place that you want tt. 
No problem - once you've 
pressed Enter to say you're 
happy with the text, you can 
then move the text with the 
cursor keys in any direction to 
the position you want Try it 
When you're ready, press Enter 


© 


again and the text will be 
positioned in that spot 

Suppose the text you've just 
put in was a mistake or you 
changed your mind about 
where you wanted it Just press 
F3 to get into command mode 
(like Quill. Select E for Edit from 
the command menu in the 
control area. Press T to select 
the Text option. Now move the 
crosswires until they are 
somewhere at or near the text 
you've just keyed in. Now press 
Enter. As if by magic, the text is 
now displayed on the input line 
for you to edit as required. This 
can be done with the standard 
Ctr-left or -right and retyped as 
appropriate. However what we 
are going to do - is get rid of it 
altogether. Do this by pressing 
F4, and the text will disappear. 
Try to remember the use of F4 
for deleting, as it will come up 
again and not just for the text 
option. 

If necessary now press Esc 
until you are out of command 
mode and back into input 
mode. You will recall that we 
started off by putting in a value 
of 25 for Jan into our graph. 
What we need to do now is to 
get red of that value because 
we're going to create a new set 
of figures, and change all the 
other items you see on the 
display to make our customised 
graph or chart 

Get the crosswires back to 
Jan, by keying in Shifttab until 
they are over Jan. To delete the 
value of 25 we can either press 
F4, or simply overwrite the value 
directly with a new value. Lets 
just press F4 on this occasion. 
We now have a blank graph 
again so we can start from 
scratch. Position the crosswires 
back on Jan. | hope you can 
remember how this is done! 


Feeding plans! 


Say you were an interested 
parent doing a small PTA 
project involving something like 
schoolchildren’s meal 


preferences at school. You were 
researching both boys and girls, 
a certain number of each, and 
noting their choice of a 
particular meal type. Your table 
of results might look something 
like this: 


Boys’ Girls’ 
Cooked 5 6 
Takeaway 3 4 
Sandwich 4 3 
Snacks 3 2 


Some of you will have 
grasped that this type of table is 
typical of an Abacus 
spreadsheet in appearance and 
application, and this is indeed 
so. They both after all display the 
same values. Its merely the 
method of presentation that's 
different. 

For now we will confine 
ourselves to Easel. Let's start 
creating our graph. Starting with 
the boys, key in 5, then 3, then 4, 
then 3, ie the values on the table 
above, not forgetting Enter after 
each one. You now have four 
bars on screen of varying 
heights representing those 
values. Notice how each new 
value caused the crosswires to 
move one cell to the night 


Title and text 


We now need a title. Let's 
make it ‘Meal Choices’. Well 
leave out ‘boys’ as we will use 
this to distinguish from the 
second set of figures we will key 
in for the girls subsequently. As 
before, key in F3 then E for Edit 
then T for Text Move the 
crosswires close to Title’ and 
press Enter. Title’ will be 
displayed on the input line at 
the cursor prompt. Remove this 
text (you should know how by 
now; if not, read back a few 
paragraphs). See how the text 
both disappears from the input 
line and the display at the same 
time. In its place enter ‘Meal 
Choices’, You don’t need the 
quote marks, but | won't go on 
telling you this. Press Enter, then 


Henry Orlowski creates 
a custom graph - Load 
up Easel and follow him. 


move the text to a central 
position near the top of the 
graph. Again you should know 
how to do this now. 

At the end of a command, 
Easel is inclined to stay in the 
command mode until you press 
Esc to retum to input mode. Do 
it now. | won't remind you again 
after this. 

Now we will put in another 
item of text, ‘Boys’ to distinguish 
this graph from the one we will 
do for the girls. Get into text entry 
mode. Remember that you do 
this by pressing the single or 
double quotation marks. Key in 
‘BOYS' then Enter, and position it 
somewhere near the top left 
hand comer of the graph using 
the cursor keys. Key Enter when 
satisfied with the position. 


Changing labels 


Now we need to do 
something about those months 
of the year. These are known as 
‘labels’ and the labels we need 
in this case are types of meal 
rather than months of the year. 
Get into command mode and E 
for Edit then L for Labels. The 
crosswires will attach 
themselves to a cell and the 
label of that cell will be 
displayed on the input line. Get 
them to Jan if not already there, 
and use the line editor to 
change Jan to ‘Cooked’, but 
don't press Enter. 

You will now have ‘Cooked’ as 
your first cell label, You will still 
be in the edit label mode, so 
Tab to Feb. Change that to 
‘Takeaway then change Mar to 
‘Sandwich’ then finally Apr to 
‘Snacks’. Press Esc until you 
have exitted the command 
mode. Only part of some of your 
labels may be visible in the 
display but don't wory about 
that at this stage. 

We now need to do 
something about Axis 1, the 
horizontal axis. Return to Edit 
mode, this time selecting A for 
Axis then H for horizontal. 
Change Axis 1 to Type of Meaf. 
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bi cheng i 
Le TFB od for next label, 
TER to end 
Press Fd to delete iabel 


fea! Preferences 
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Format @ Rep BAR @ 


Current Home figures 


Move the text to a central 
position and press Enter. 

Let me just point out at this 
stage again that | will no longer 
give you the exact keys to press 
every time because | consider 
you should have grasped it by 
now. So you just have to 
remember to do things like 
press Enter to finish, how to 
enter different modes, how to 
get out of different modes, which 
keypresses give specific results, 
etc. 

The vertical axis also needs 
some editting. Use the E for Edit 
mode then V for vertical axis and 
change Axis 2 to 'Number and 
position centrally. 


Kill « cell 


The graph is now starting to 
look the part. The one remaining 
aspect that still needs sorting is 
the fact that we still have the 


SD OrS c= 


| Cooked 


May to Dec labels intact. If you 
delete the labels, the cell may 
still be there albeit without a 
label or name. To delete a cell 
altogether, we must delete its 
value and its label. In this case 
these cells have not had any 
values entered into them so we 
are part of the way there. 
Remember how we deleted 
values before in case you ever 
need to do this again. Use the 
Edit mode with L for Label, and 
F4 to delete all the remaining 
labels. 

Notice again how Easel 
helpfully keeps you in that mode 
and moves on to the next cell 
as you continue, speeding up 
the whole operation immensely. 
When you get to Dec, Easel 
opens up another range of cells 
for you, and presents you with 
an even greater crowding 
problem. This is Easel just trying 
to be helpful. It doesn't know 


Task graphs 
7B6K Memory 


that you don't want any more 
cells. 

Don't worry. Instead just enter 
command mode again and this 
time select V for View. At the 
input line cursor prompt accept 
‘All figures’ by Enter, and accept 
the format in the same way. 
Don't worry about these at this 
stage. All will be revealed later 
on, it's just that it's easier now to 
allow Easel to get on with it, 

As if by magic our graph is 
now redrawn on screen but 
without the unwanted cells and 
labels but with the wanted cells 
expanded to take up the 
available display width. Not only 
that, but there is now enough 
room for the whole text of the 
cell labels to be visible. 

Just compare what you see 
now on screen to the table of 
values we started with. Which do 
you prefer? If you prefer the 
Easel version, and it's purely a 


__ Meal Preferences 


Takequay 
Type of Neal 
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Sandwich 


Snacks 


subjective matter, then you may 
just have experienced what 
Easel is all about and what it 
can do to enliven a bland set of 
figures by giving them extra 
impact 


Naming sets 


We're still not there, because 
we have still to think of the girls, 
whose results we will compare 
with the boys. Firstly however to 
avoid confusion between 
different sets of figures we need 
to name this set something 
instantly recognisable. In the 
status area you will see that the 
current name for the set of 
figures is figures’. This is the 
default that Easel gives when 
you first enter a set of figures. 
However it would make more 
sense to us to have it called 
something like ‘boys’. To do this 
we use the ‘Rename’ command. 
Of course it is not always 
necessary to call your set of 
figures a special name, 
especially when you are only 
using one set at a time, but in 
this case we need another set 
for the girls. 

The rename command is 
accessed by selecting R for 
Rename in the command mode. 
At the prompt type in or accept 
the old name of the set of 
figures, in this case ‘figures’, then 
Enter, then type in the new 
name, ‘boys’, then Enter again. 
Notice that ‘boys’ is now 
reported as the current set of 
figures in the status area. 

Next month we will look at 
how we can efficiently create the 

girls’ graph and 
compare the two in 
tandem. We will also 
look at various options 
to customise our graph 
exactly to our 
requirements. 

Before you switch off, 
save the work we've 
done so that you can 
load it up again next 
month. To do this you 
select S for Save from 
the command menu. At 
the prompt, key in the 
filename, say ‘meals’ not 
forgetting the drive 
specifier, eg flp2_meals, 
unless your data 
defaults are 
automatically set up. 
This will save all figures 
currently in memory. 
Then press Q for quit to 


exit Easel. 


Bryan Davies 
goes back to 
basics with 


some readers’ 
letters 


: 


his month's article is 
concemed solely with 
readers’ letters. 
Roland Kaiser wrote 
about using 


Perfection for German 
corespondence. He had 
apparently misunderstood 
information given to him about 
using the Perfection 
spellchecker. While Perfection 
itself can handle the “special” 
German characters (eg those 
with umlauts), the spellchecker 
is primarily for use in checking 
English words, as would be 
expected from the fact that the 
word lists supplied are in 
English only. Word list files for 
other languages can be created 
by users, but they should not 
contain characters which are not 
in the standard English- 
language set The spelichecker 
regards non-standard characters 
as being gaps between words, 


oe 


so that German words having 
these characters will be split into 
two or more pieces by the 
spellchecker, each piece being 
checked separately. Geoff Wicks 
mentioned this point in 
connection with the Dutch 
language, in his letter published 
in Open Channel in the 
December 1992 issue of QL 
World. 

Following recent meetings of 
a local Quanta group, Mick 
Halpin asked that a few basic 
points be repeated, for new 
users like him. As he says, 
however well-known some 
operations on the QL are to 
experienced users, there are still 
users who do not understand 
how to do some fairly simple 
things, and cannot readily track 
down articles which dealt with 
them in the past They may not 
know where to look in the QL 
User Guide for help, either, 
although they should certainly 
read that book through carefully, 
more than once, as it is 
generally helpful. Here are some 
of the items he asked for advice 
on. 


Date and time 


On the SuperBasic command 
line, type: 


SDATE 1992,12,23,07,35,30 


then press Enter. This will alter 
the internal date to 23 
December 1992 and the time to 
0735 hours 30 seconds (24-hour 
clock). For any other date and/or 
time, alter the digits after SDATE 
- first comes the year {all four 
digits), then the month (one or 
two digits), the day (one or two 
digits), the hour (one or two 
digits), the minutes past the hour 
(one or two digits), and the 
seconds {one or two digits). 
There must be a comma 
between each of these groups 
of digits, and a space between 
SDATE and the first digit To see 
what the set date and time are, 
type: 


PRINT DATES 


and press Enter. Many people 
do not bother about setting the 
time, and this may cause them 
no trouble, but you need to be 
aware that there are 
circumstances in which it can 
cause problems. For instance, if 
you run an accounting program 
and need to have back-up 
copies in chronological order, 
you will not be able to do this 
without making sure the clock is 
correctly set When you come to 
check which is the latest version 
out of two copies of the same 
file, how can you tell (quickly), if 
the date stamp on both is 
incorrect? 


Formatting disks 


This job is basically the same 
for disks and microcartridges. 
Type: 


FORMAT devn_label 


then press Enter. For “devn’, 
use the device and its number, 
that the medium to be formatted 
is in. That is, if you want to 
format a disk in the first floppy 
drive, insert “flp1”. For “label”, 
insert whatever name you want 
to give to the media; there is no 
need to give any name at all, but 
it can be useful (later) to be able 
to identify disks and cartridges 
by such labels. The same rules 
apply to labels as to file names, 
and you can use names like 
“wp letters”. The Format 
operation is not the same as 
Delete; formatting prepares the 
magnetic media for use, and no 
cartridge or disk is any use until 
it has been formatted. Delete 
merely gets rid of any files that 
are on an already-formatted 
medium. There is normally no 
need to use Format a second 
time, but it should be used if 
deleting all files does not yield 
the full number of free sectors. 
Miracle Systems caution users 
about possible problems when 


S/7OOTC/S 


formatting disks to higher 
capacity than the drive being 
used; for example, formatting a 
HD disk in a DD drive should 
give 720 KB capacity, but there 
is some uncertainty about this. 

Software ramdisks are 
essentially the same as 
hardware floppies or cartridges 
in use, but there are a couple of 
different types, called fixed and 
dynamic. The fixed ramdisk 
does not change size unless 
you issue a revised Format 
command for it The size of the 
disk is specified in sectors - that 
is, the figure used is twice the 
figure for the kilobytes space 
required. Type: 


FORMAT ram1 600 


to get a 300 KB ramdisk. The 
dynamic version changes size 
according to what is going on in 
the QL in the way of programs 
being run. Initially, all the 
available memory is combined 
and called Ram1_. If another 
program is then run, memory will 
be taken from Ram1_ to allow 
running of the program. A big 
advantage of this flexibility is that 
you can run Archive programs 
with the database files in 
ramdisk and - provided there is 
enough memory - you don't 
have to worry about how much 
space the files take up. With the 
fixed form, you have to issue a 
Format command, to set a disk 
large enough to hold the 
maximum size of database file 
you expect to work with in the 
current session, and the 
command has to be issued 
before you start running the 
program. The dynamic disk 
allows you to simply copy the 
database file to ram, without 
using Format at all. 

To change the size of a fixed 
ramdisk, you have to reduce it to 
zero first: 


FORMAT rami 0 


then set it to the new size. A 
dynamic disk can be changed 
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in size by simply issuing the 
Format command again, with 
the new size. Both types need to 
be empty of files before the size 
is changed. As the dynamic disk 
takes all available free memory 
by default, the effect of reducing 
its size is to create another one 
to take up the freed space. For 
example, with 300 KB free, you 
get Ram1_600. If you then 
format Ram2_300, that 
automatically reduces the first 
disk to Ram1_300. Naturally, any 
files stored in existing disks 
place limitations on the space 
left to be allocated to new disks. 
As with other devices, there is a 
limit of eight, so Ram8_ is the 
last one you can have. 


Switching on 


All equipment manufacturers 
{so far as | arn aware) advise 
that high-power devices be 
switched on first This is to try 
and avoid surges of electrical 
current passing from high-power 
devices into the computer itself 
and damaging it. In practice, this 
means switching on printer, 
display, drives, then - last - QL 
One chip in the QL - the 8301 - 
tends to be very touchy, 
because it is not protected by 
any form of buffering from 
surges of current emanating 
from other devices. In particular, 
the display can “kill” the 8301 if 
switched on after the QL The 
order of switching off should be 
the reverse one - that is, switch 
the QL off first As | have said 
before, my own practice is not to 
do what the manufacturers 


advise, simply because it is very _ 


inconvenient Going round alll 
the switches one-by-one is a 
nuisance. Instead of this 
procedure, all my system 
devices - including the QL - are 
connected to one multiple 
socket and are switched on and 
off together. As this procedure 
has not resulted in any failures 
over eight years, it would appear 
to be a safe one. To some 
extent, the safety or otherwise of 
the procedure must depend 
upon how well designed the 
equipment is. Clearly, the old 
QLs in particular leave 
something to be desired in this 
respect, but the Microvitec Cub 
display on my system would 
appear not to cause trouble for 
the 8301 chip. Be aware, though, 
that other displays may not be 
as obliging. 


Disks in drives 


This subject is related to 
switching on the system, in that 
the QL does not provide good 
protection for disks during the 
switching period. Files and/or 
directory information can get 
corupted if disks are in drives at 
switch-on or switch-off time, so 
switch on first, then push the 
disks in. Likewise, pop disks out 
before switching off. This advice 
does not apply for resetting the 
QL unless something is wrong 
with the QL resetting should not 
harm any disks which are 
inserted in drives. The same 
should apply to cartridges, 
although | have always tended 
to remove them before resetting; 
maybe they are less-well 
protected than disks. To ensure 
that the system boots 
automatically from a disk or 
cartridge, the latter has to be 
pushed in promptly after the 
system has been switched on, 
before the F1/F2 initial screen 
appears. The order of priority for 
booting is madly, flp, win; that is, 
the system will not boot 
automatically from a hard drive if 
either a cartridge or a disk are 
already inserted in mdv1/flp1. 


Write-protection 


Cartridges and disks are 
similar to music cassettes in 
having small tabs which prevent 
existing data being overwritten 
or deleted. The cartridge has a 
tab on its right side (as viewed 
when pushed-into the drive) 
when it is supplied new. To 
protect the information on the 
cartridge, the tab can be cut off 
(using a pair of electrical side- 
cutters, for example), It is 
desirable to remove the tab from 
all your important master 
program cartridges. When the 
time comes to modify files on a 
cartridge, or add new ones, the 
protection can be removed by 
placing a piece of tape over the 
cutout that the tab covered. 
Unlike disks, the cartridge tab is 
for mechanical, not optical 
sensing; the tab actuates a 
microswitch via a lever, when 
the cartridge is pushed into the 
drive. It is sufficient to replace it 
by a piece of thin transparent 
sticky tape. Don't use a bigger 
piece than is necessary to 
bridge the gap, and avoid 
folding it undemeath the 
cartridge, to prevent 
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misalignment of the cartridge 
when in the drive. 

Disks of both sizes have tabs 
which are detected by optical 
sensor; the presence of the tab 
prevents the disks being written 
to. 5.25-inch disks have a cutout 
on the left edge, and this will be 
uncovered when the disk is 
supplied new. Place a piece of 
tape over the cutout to protect 
files on master program disks. 
The tape must be opaque - 
transparent sticky tape is not 
suitable. If you don't have any of 
the black or silver tabs supplied 
with new disks, use black 
electrical insulating tape. Apply it 
neatly and firmly - it can get 
stuck inside the drive and cause 
you a lot of trouble, and maybe 
necessitate a repair. (Be aware 
that electrical tape can go sticky 
after a few months or years not 
good in the drives) 3.5-inch 
disks have a much neater 
arrangement - a slider at the 
front left comer. On new disks, 
the slider will be pushed away 
from the front edge of the disk, 
and it will be covering the 
square hole that the optical 
sensor looks for. In this 
condition, disks can be written 
to. To protect them, push the 
slider to the outside edge, 
uncovering the hole. DD, HD 
and ED disks are all the same in 
this respect. The other square 
holes that HD and ED disks 
have are there for density- 
recognition purposes - a Square 
hole on the right edge, located 
the same distance from the front 
edge as the write-protect hole, 
indicates an HD disk, whereas a 
similar hole located slightly 
further down the right edge 
indicates an ED disk. 


Saving files 


This is a very basic operation, 
which all users should be 
familiar with, but there are 
variations of it, depending upon 
what program is being run. Quilf 
and the other Psion programs 
have a Save command which is 
essentially the same for all, but 
there is one slight difference in 
what the user has to do. When 
you select the Save command, 
the current (screen) file will be 
saved to cartridge or disk, under 
the name you give it at the time, 
or the name it already had when 
you loaded it If a version of the 
file already exists on the 
medium, you will be asked 
whether or not you want it to be 


overwnitten by the current 
version. Depending on which 
program you are using, the 
answer has to be pressing the Y 
(yes) or the Enter key, to cause 
the existing file to be overwritten. 
The Enter key is used as a way 
of saying “yes” in some 
programs - such as The Editor - 
but that convention is not 
followed in many other 
programs and you have to 
answer ‘y' with them. The 
standard QL Basic has a Save 
command, but it does not ask 
whether or not an existing file 
should be overwritten; when a 
file of the same name exists, the 
Save command simply does 
nothing, but you get the 
message "already exists” You 
have to Delete the existing file 
first, then Save the new version - 
a tiresome procedure, although 
it does help prevent overwriting 
a wanted file by accident. Many 
systems have some form of 
Toolkit installed and they usually 
have the modified command 
SAVE .O; this automatically 
overwrites an existing file of the 
same name. This command is 
very useful when you are 
modifying boot files. 


Backing up files 


There can be confusion over 
the use of the terms “back-up" 
and “make a copy”. They are 
essentially the same. Quill has 
a Backup command, 
SuperBasic has a Copy 
command; both do the same 
job, which is to make a copy of 
a file on one medium onto 
another medium. You end up 
with two identical files, each 
having the same file name but 
being on different disks or 
cartridges. It does not matter 
what the file is - data or a 
program. You are making a 
spare copy for security 
reasons; that is, in case the 
original file gets deleted or 
corrupted. In Quill, there is no 
effective difference between 
using the Save and the Backup 
commands. If you Save to 
different media one after the 
other, that is the same as using 
Backup to make a copy from 
one medium to another. There 
is some difference between 
what the commands can be 
used for. The Backup 
command can be used to load 
a new PRINTER_DAT file, to 
enable printing to another 
printer or with a different set of 
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Translate settings without 
having to exit Quill. The Save 
command is strictly for DOC 
files. Both commands have the 
confirmation request, which is 
made if a file of the same 
name as the current one 
already exists on the 
destination medium. 

In Basic, Copy is like Save in 
that it will not overwrite an 
existing file of the same name, 
but you get the “already exists" 
message. Toolkit commands 
include WCOPY (‘wild-card 
copy’), which is much more 
useful than the basic Copy. 
You can copy any or all files 
from one medium to another, 
by making use of the Y/N/A/Q 
query which appears after you 
have issued the command. The 
procedure is to type: 


WCOPY flp1_fip2_ 


then Enter. You will be asked 
what you want to do about the 
first file (in alphabetic order on 
the source disk (flp1 in this 
case). Y to copy it, N to skip over 
it, A to copy this file and all 
others following it, Q to quit the 
command there and then. 
Choosing A or Q leaves you 
with no more questions to 
answer about file names (except 
as noted below) - all the files 
from there on are scheduled to 
be copied, or the command is 
cancelled right away. Y or N in 
answer to the first question bring 
up the next file name and the 
same question, and so on. You 
can be completely selective in 
what you want to copy. Y and A 
bring up a further question - 
overwrite or not? - with the same 
four options, if a file of the same 
name is eventually found on the 
destination medium. Hopefully, 
after this two-stage waming, you 
should have been alerted to the 
possibility of overwriting files 
which you do not actually want 
changed. 


Quill loading 


Quill cropped up again in a 
letter from G T Morris. He uses 
TaskMaster for switching 
programs and finds that Quill 
will load only about half of a 
17,400-word file (the Gospel of 
St. John). The remainder of the 
file appears as “only two or 
three letters at the beginning of 
each line”. By splitting the file 
into two halves, he has been 
able to load one half and 
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merge the other half into it If | 
understand what he says 
correctly, the second half was 
saved using another WP 
program. The Quill version he 
is using is 2.35, which is the 
best one available, and it 
should not give problems 
loading a file of this size. It was 
a long time since | had worked 
with TaskMaster, but it seemed 
likely that the memory 
allocation set up in that 
program, for Quill, was too 
small Another possibility was 
that Quill could not overflow the 
large file onto disk because 
there was not enough space 
there. There is a file size limit 
beyond which Quill 2.35 gives 
trouble, but | found that it was 
around 600 KB and the Morris 
file should be much smaller 
than this. Apart from the usual 
problem of slowness, and 
occasional hiccups, there 
should be no real difficulty in 
handling, say, 250 KB files. 

To check Quills behaviour 
under TaskMaster with large 
files, | set TaskMaster up with 
the default allocation of 65000 
bytes of memory for Quill, then 
tried to load a 117 KB, 17,000- 
word _DOC file. The first try 
produced a typical Quill “no 
can do” message, presumably 
because the data disk did not 
have enough free space to 
allow Quill to overflow the 
loaded file back onto that disk. 
When enough space was left 
free on the disk, the file started 
to load, but the QL locked up, 
with just the first line of the file 
displayed on the screen. The 
DEF_TMP file on the disk was 
exactly the same size as the 
main file, indicating that the 
load attempt was almost 
complete. The third try was 
successful. The next file tried 
was 145 KB and 22,000 words. 
This loaded remarkably quickly, 
thanks to the Gold Card, and 
gave no trouble. A 173 KB, 
27,000-word file also loaded 
quickly and without trouble. At 
this point, it seemed time to “go 
for broke”, and the next file 
wheeled in was 288 KB and 
42,000 words. This was going 
to be a close thing, as there 
was about 576 KB of space on 
the disk, for the main and 
temporary files. Sure enough - 
“out of memory’, with a word- 
count of -2212. Quill runs out of 
steam when counting words at 
around 25,000 to the best of 
my recollection. 


Not obvious 


The reason for not loading 
was not the obvious one, 
however. There was still 9 KB 
of free space on the disk, and 
main and temporary files on 
there were the correct size. 
Trying again with more free 
space on the disk gave the 
same result. Increasing the 
memory allocated to Quill by 
TaskMaster to 70,000 bytes did 
the trick - for a while. A few 
moves down the document 
with SHIFT+Down Arrow had 
the “out of memory” message 
flashing again. However, you 
have to accept that Quill 
operation will always be 
borderline with large files if 
only 60-70 KB space is 
allocated to it; 80-100 KB is 
much better. One point to bear 
in mind when disk space 
becomes scarce, and a 
document is overflowing, is 
that you can put the 
cartridge/disk with the 
document file on it into 
mdv1/flp1 and load it from 
there; if you put a blank, 
formatted cartridge/disk in 
mdv2/fip2 for the overflow, both 
main and overflow files can be 
roughly the size of the 
medium. 

That is only a partial answer 
to GT Morris's letter. Yes, Quill 
is capable of loading files 
much larger than 17,000 words 
(assuming the file size is in 
proportion to the number of 
words and is not considerably 
inflated by formatting 
information). No, | have no idea 
why it should load a file with 
the last half of it being shown 
as just a few characters per 
line. On second thoughts, there 
is one thing | noted about Quill 
years ago, and that is that it 
sometimes loads the bulk of a 
file, then baulks at some 
character(s) - possibly not 
displayed on-screen - it comes 
across, with the result that the 
remainder of the file looks like 
nonsense. To deal with this, 
you can make a copy of a few 
pages around the suspected 
area of text, then delete that 
area and see if loading is now 
successful. If it is, the removed 
text can be merged back in, 
block by block, and loading 
checked, until it is established 
just where the problem lies; 
any remaining text can then be 
re-typed in. 


Card query 


Miguel Estarellas of Madrid 
wrote in September and 
November about a dispute he 
has with TK Computerware. 
Items that he ordered earlier in 
1992 had not been received, but 
his credit card account was 
debited for purchase of them. 
He will presumably have since 
realised from comments in this 
column that TK has not been 
responding for six months or so 
to requests for information on 
several complaints. We can only 
advise that Estarellas make a 
claim to his credit card 
company for refund of any 
payment against which goods 
have not been received. He 
could also write for advice to the 
local Trading Standards Office in 
the area where TK is based (see 
INFORMATION). 


INFORMATION 

(The publication from which 
the following addresses were 
taken is out-of-date and the 
information may not be correct, 
but letters addressed as below 
should be forwarded to the 
proper place automatically) 


B R Toone 

Area Trading Standards 
Officer 

County Offices 

Tufton Street 

Ashford 

Kent TN23 1BU 


G E Edwards 

Area Trading Standards 
Officer 

9/10 Crescent Road 
Tunbridge Wells 

Kent TN1 2LU 
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Beginners 
start here. 
This month, 
Alan 
Bridewell 
explains 
machine 
code - from 
the bottom. 


veryone who has had 

a computer for any 

length of time will 

have heard about 

machine code, If they 
don't ever leam anything else 
about it, the one thing they will 
find out is that to program 
computers like the experts do, 
they will have to learn about 
machine code. (This is not 
actually true - but that's another 
story) What is true is that the 
ability to introduce a bit of 
machine code into your 
SuperBasic programs can 
improve them out of all 
recognition, both in speed and 
in flexibility. 

In this series, my aim will be to 
explain in simple terms whal a 
beginner needs to know to get 
going, So | will be looking at 
what machine code actually is, 
at what assembler language is 
and what assemblers do, and at 
many of the instructions needed 
for programming. In each article 
there will be simple listings to 
illustrate what has been covered. 
In order to make even very short, 
simple listings do something 
obvious and visible, | shall make 
all of them do something on the 
screen. At some stage it will be 
necessary to explain exactly 
how the QL interprets data for 


LISTING 1 
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the screen, but at the start this 
will not be needed. 


What is it? 


So what is machine code? A 
computer is an electrical device, 
which treats low voltages as 
number zero, and high voltages 
as number one. By putting these 
ones and zeros together, the 
computer can make any 
number you like (within reason). 
In the computer, these numbers 
are stored in memory locations. 
Each memory location has a 
unique number, called its 
address, which has to be stated 
whenever that memory location 
is to be used. 

Memory locations in a 
computer are of two types. There 
is rom (read only memory). With 
this type of memory, the number 
stored can be read, and used, 
but it cannot be changed. All the 
computer code which is present 
when you first switch on your 
computer is stored in its rom. 

The other type of memory is 
ram (random access memory, 
which is an obsolete name that 
ought to be changed, but | don't 
suppose it will be now. The best 
thing is to forget what the initials 
actually stand for, and just 
remember what ram actually is) 
With this type of memory, the 
number stored can be read and 
used like rom, but, unlike the 
rom, it can also be altered. 
When people talk about how 
much memory a computer has, 
they normally mean how much 
ram it has available. 

Ram and rom are each stored 
in separate memory chips within 
the body of the computer. 


MOVE .B 
MOVE. W 
MOVE.L 
RTS 
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#FF ,$21000 
H##F FFF , 22000 
#FFFFEFFF , #23000 


Different things 


The numbers stored by the 
computer can be used to mean 
different things. They can be 
simply what they are, numbers, 
to be used in whatever way our 
program requires. They can also 
be used as the addresses of 
other numbers stored in ram 
and rom. They can be 
instructions which the computer 
uses to manipulate the numbers 
in its memory. For hardware 
items like monitors, printers, 
modems, etc, the numbers can 
represent characters to print or 
transmit (If you have other things 
attatched to your computer, like 
robot arms, or sound systems, 
the numbers can represent 
other types of information you 
may need to give them, or 
receive from them. 

The heart of your computer is 
the microprocessor chip (also 
called the central processing 
unit or cpu). This is a device 
which manipulates all these 
numbers, treating some as 
instructions to manipulate other 
numbers, Some as addresses to 
store and retrieve numbers, and 
some directly (as actual 
numbers in an arithmetical 
calculation, for instance). 

How do the numbers ‘travel’ 
from the keyboard, or the rom or 
ram chips, to the 
microprocessor and back 
again? As tiny pulses of 
electricity, originating (usually) 
either with keying on the 
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keyboard, or as stored one/zero 
sequences on a magnetic 
medium such as a disk or 
microcassette. Put simply, a key 
operated at the keyboard is 
translated within the computer 
into a predetermined sequence 
of electrical pulses, which travel 
round the innards, and (if they 
are the correct combination) will 
trip further clumps of pulses 
(binary numbers) which initiate 
other sequences, and so on like 
an incredibly complex domino- 
pattem. Which is why computers 
need exact instructions before 
they can perform a given 
calculation - your computer 
cannot guess what you mean. 


Hexadecimal 


For reasons that we need not 
mention here, the numbering 
system used on assembler 
language is not written in the 
conventional way. We are used 
to numbers in ‘base ten’, or the 
‘decimal’ system for everyday 
arithmetic. In this system we 
have ten digits to represent the 
numbers 0, 1, 2, 3, 4, 5, 6, 7,8 
and 9. For bigger numbers, we 
use more than one digit in a 
group to represent tens, 
hundreds, etc. So, for example, 
we write '655' to mean five lots 
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of one hundred plus five lots of 
ten plus five, or five hundred and 
fifty five. Each digit is a number 
ten times bigger than the same 
digit on its right 

Our assembler language uses 
numbers in ‘base sixteen’, or the 
‘hexadecimal system. It obeys 
the same rules as the decimal 
system, except that it uses 16 
digits to represent the numbers 
0 to fifteen. As we only have ten 
normal digits, to represent 0 to 
nine, the numbers ten to fifteen 
are represented by the letters A, 
B, C, D, E and F. For bigger 
numbers, we use a second digit 
to represent sixteens, a third to 
represent sixteens times sixteen, 
etc. So in this system, 555 would 
mean five times sixteen times 
sixteen, plus five times sixteen, 
plus five, which comes to one 
thousand three hundred and 
sixty five (I think!). If a 
hexadecimal number contains 
one or more of the letters as 
digits, then it's obviously 
hexadecimal. But if it doesn't, 
then we need a way to fell us. 
The normal convention is to put 
a dollar sign in front So 555 is 
decimal, but $555 is 
hexadecimal. 

If this is confusing - don’t 
wory about it Most of the time 
we don't need to know what a 
particular hexadecimal number 
is in decimal. We simply need to 
be aware of the fact that the 
numbers we are using are not 
decimal numbers. 


Word lengths 


The microprocessor can 
handle numbers in three 
different sizes. First, there are 
bytes. A byte occupies one 
address only, and has a size 
from 0 to 255 in decimal, or $0 
to SFF in hexadecimal. Next, 
comes a word. A word occupies 
two consecutive addresses, the 
first one always being an even 
number. Its size can be from 0 
to 65535 in decimal, or $0 to 
SFFFF in hexadecimal. Last, 
comes a long word. A long word 
occupies four consecutive 
addresses, with again the first 
one always being an even 
number. Its size in hexadecimal 
can be from $0 to SFFFFFFFF, 
which is 4 294 967 295 in 
decimal. 

This language of numbers is 
very difficult for human minds to 
deal with. (Early workers in 
computers believed this meant 
that only a tiny number of 
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people would ever be capable 
of programming effectively - 
what a shock they would get 
today to see primary school 
children doing it at school!) The 
answer was of course the 
invention of programming 
languages that human minds 
could deal with. However, 
conversely, the easier it is for 
human minds to handle the 
languages, the more difficult it is 
for the computer. Assembler 
language is a language that can 
be converted into machine code 
directly, and so is easy for the 
computer to use effectively. It is 
also possible for the human 
mind to make sense of it, which 
makes it the vehicle for human 
beings to write programs in 
machine code, without actually 
learning machine code. 


Assemblers 


Converting assembler 
language into machine code 
requires a special program, 
called an assembler. If you are 
interested in starting machine 
code programming, you really 
have to get yourself an 
assembler. Any QL assembler 
will do for work at a simple level, 
and there are a variety available 
with different levels of 
sophistication and price. Top of 
the range is probably the GST 
Macro Assembler, which has all 
the bells and whistles any 
professional programmer might 
want. Somewhere in the middle 
comes Assembler Workbench 
by Talent | am not 
recommending or advertising 
here. With assemblers, as with 
everything else, you get what 
you pay for, and the choice is 
yOUrs, 

The one | use is the 
Assembler Workbench. The only 
reason to mention this is not to 
recommend it (although it suits 
me fine), but the fact that 
different assemblers use slightly 
different syntax (arangement of 
commands), and if you simply 
copy the listings in these articles 
without taking this into account, 
you may find they will not work 
on your assembler. The 
differences are very slight, and 
easy to deal with, and I will try to 
point them out as we go along. 


The listing 


When we write an assembler 
listing, we write It in four 


columns, not all of which are 
needed for all lines in the listing. 

The left column is for labels. 
These are simply names we 
give to certain places in the 
listing. They are very useful when 
we need to refer to one part of a 
program from another part. For 
the present, we will not be 
needing labels, so more about 
them later. 

The next column contains the 
mnemonics for the actual 
instructions. These are things 
like ‘BSR’ for ‘ branch to 
subroutine, and 'RTS' for ‘return 
from subroutine’. 

The third column contains the 
data (called operands) on which 
the instruction is carried out. Not 
all instructions require operands. 
‘RTS’, for instance, means return 
to wherever you got to in the 
program before you jumped to 
this subroutine, and it needs no 
operand. ‘BSR’, on the other 
hand, needs an operand in the 
form of an address of the 
subroutine. ‘MOVE! instructions 
need two operands, one to tell 
you what to move, and the other 
to tell you where to move it, the 
two operands being separated 
by a comma. 

The right hand column is for 
comments, like REMark 
statements in SuperBasic. The 
assembler ignores them, but 
leave them out at your peril! 
Good comments can tum an 
incomprehensible listing into 
something you can understand. 
Even if you understood what you 
were doing when you wrote a 
program, the chances are you 
will not understand what you 
have written when you retum to 
it later unless you make good 
use of comments. Comments 
can also sometimes spread 
across all the columns. 


Doing something 


That's enough basic 
principles for the time being. 
Let's get on to the first listings. | 
said earlier that all examples will 
do something visible on the 
screen. The QL stores all the 
information for the screen at a 
consecutive set of rarn 
addresses from $20000 to 
$27FFF (Remember, the dollar 
sign means the numbers are 
hexadecimal). When these 
addresses all contain zeros, the 
screen is completely blank. 
What we shall do is use 
SuperBasic to produce a blank 
screen, and use a bit of 


machine cade to put other 
numbers at a few addresses to 
see the effect. 

At this point, we need to deal 
with an important point of 
syntax, which is: how does the 
assembler know when a 
number is just a number, and 
when it is an address? The 
answer is this, If the number is 
written as just a number, the 
assembler takes it to mean an 
address. If it is written with a 
hash (#) symbol in front, it is 
taken to mean a number. So, for 
example, $1C4D means 
address $1C4D to the 
assembler, but #$1C4D mean 
the actual number $1C4D to the 
assembler. 

If you look at listing one, you 
will see that the first line of code 
reads: 


MOVE.B #$FF$21000 


MOVE.B means 'move a byte 
sized number. The number we 
are moving is #$FF, (the ‘#' 
means its just a number), and 
we are moving it into ram 
address $21000 (no ‘# means 
it's an address). 

The next line is very similar, 
except that this time we shall 
move a word into another 
address (well, two addresses to 
be precise) with the instruction 


MOVEW #$FFFF, $22000 


and thirdly, we shall move a 
long word into a third address 
(that is, four consecutive 
addresses) with the command 


MOVE.L #$FFFFFFFF,$23000 


As these addresses are all in 
the part of the ram used to store 
screen information, the three 
instructions should all put 
something on the QL screen. 
Since our bit of machine code is 
going tobe called from 
SuperBasic as a subroutine, we 
need to get back into 
SuperBasic with a fourth line, 
which simply says 


RTS 


You will notice that, in Listing 
one, all the comments begin 
with a semicolon (). In the 
Assembler Workbench, this is an 
essential piece of sytax to tell 
the assembler that what is to 
follow is a comment, and must 
be ignored. 
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Syntaxes 


This sytax is not followed by 
all assemblers. For instance, if 
you look at Simon Goodwin's 
listings in his DIY Toolkit articles, 
the comments need nothing in 
front, as long as they are 
restricted to the fourth coloumn. 
But if they go across other 
columns, they must be 
preceeded by an asterisk (*). 
You must look carefully through 
the manual for your assembler 
to see exactly what syntax it 
uses. If you can't find it, you may 
be forced to try a little trial and 
error. 

Our next problem is to get the 
assembler to process the listing. 
You may find that you can type 
the listing straight into the 
assembler. This is very 
convenient for very short listings 
like this, but becomes 
impossibly complicted with 
longer listings, especially when 
you find errors, as you almost 
certainly will. The normal way is 
to store your listing as a disk or 
microdrive file, which can then 
be accessed by the assembler 
by giving the program the name 
of the file. How this is done 
varies greatly from one 
assembler to another, and you 
will have to consult the manual 
to find out. 

Having said that, since the 
name of an assembler code file 
is the most common information 
you feed into an assembler, the 
manual should make obvious 
how to do it! The other 
information the assembler will 
need is what address to start 
putting the machine code it is 
generating, and also the name 
of a disc or microdrive file to 
save the code. Again, consult 
the manual. 


With SuperBasic 


Once we have generated our 
machine code file, we need to 
be able to use it in a SuperBasic 
program as a subroutine. The 
steps for this are quite simple, 
and always the same. First, we 
must allocate some ram to hold 
the code, using the SuperBasic 
RESPR command. Next, we 
LBYTES the file into that ram. 
Finally, when we reach the 
position in the program where 
we wish to use the subroutine, 
we simply CALL the address 
obtained by RESPR, and where 
we loaded the code. 


Listing two is a SuperBasic 
program to do all this. It also 
opens a window covering the 
entire screen, and blanks it out 
before calling the code, so you 
can see exactly what it does on 
the screen. The program 
assumes that the machine code 
is in a file called LISTING1 code 
on a floppy disc in disk drive 


LISTING 2 


100 z=RESPR (26) 


110 LBYTES flp1l_LISTING1 code,z 
120 OPEN#3,scr_512x256a0x0 


130 CLS#3 
140 CALL z 


flp1_. You may have to alter this 
to suit your needs. 
If you have not yet acquired 


statements, to show which 
assembler code produced 
which numbers} 


Small example 


When you run the SuperBasic 
program in Listing two, if you 
have done everything properly, 
the screen will 
display a short 
green line, a short 
white line, and a 
longer white line. 
Unfortunately, it 
will also produce 
a Bad parameter 
error, and the 
program will stop. 
There is no 
mistake here. To 
avoid this, we 
need an extra line of code, but 
this requires a bit more 
explaining, and | am going to 


leave this for later. 

The effects the program 
produce on the screen are not 
much to look at, and may seem 
quite meaningless. It is very 
difficult to get much to see using 
such a small amount of code, 
but at least here we can see 
something happen. When we 
lear a bit more, we can Start to 
do more interesting and 
meaningful things on the 
screen. Why we get these 
particular effects needs an 
understanding of how the QL 
interprets the data in the screen 
ram, and this will be explained 
later. Suffice to say that, with 
different numbers, the effects are 
slightly different when the 
program is run in Mode4 and 
Modeé. If you're curious about 
this, perhaps you might like to 
experiment by trying different 
numbers at different addresses. 

Happy coding! 
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then Listing 
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3 5 70 : 
inferior one - 480 KEMark Space requirements for the machine code 
when someone 496 DATA 28 
else has 560 : 
already 510 DATA "13FCOOFFG9G21000": REMark MOVE.B 
520 DATA "33FCFFFFO9622000": REMark MOVE.W 
produced the 530 DATA "23FCFFFFFPFF(0023006"; REMark MOVE.L 


definitive one? 
Thanks to 
Marcus and 
Simon) The 
difference is 
that | have 
added REMark 
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DATA "4E75"; REMark RTS 
DATA "*",2943 


#$FF,$21006 
#SPFEF 22000 
#$FFEFFFFF 239000 


29) 


Lilli  £%x% lll lr e——e—eEEEeEEEeeE—EEE—————— 


DIY TOOLkit 


Simon Goodwin describes the second part of FLEXYNET, 
the fast network link for QLs and other machines. 


xynet is a new fast 
network protocol, Last 
month | presented the 
first part of the code. 
Now | can reveal the 
rest of the assembler source 
for QL systems, and the nitty- 
gritty details of the protocol. 

Flexynet is machine and 
operating-system independent, 
and requires the minimum of 
hardware - a single bit for input 
and output - so it can be used 
to link all sorts of computer, 
from QL and Thor to ST, 
Amiga, SAM and even PCs. 

The speed is completely 
configurable at both ends of 

. the link The transmission and 
reception values count the 
number of times Flexynet goes 
round an internal waiting loop, 
so larger values mean longer 
delays. 

Transmission delay values 
are greater than reception 
delays, as the receiving 
process is fundamentally 
slower. Thus a slow QL can 
talk to a fast one more quickly 
than the fast one can answer 
back intelligibly. This should 
come as little surprise. 


Best results 


Naturally you get best results 
with a Gold Card at each end 
of the link, but even Sinclairs 
humble 7.5 MHz 68008 can 
transmit at 6K per second if 
the receiving machine is a 
16MHz Gold Card. This is 
three to six times faster than 
RS-232 or the Sinclair network 
protocol. | used NETRATE 2 to 
send and NETRATE 7 at the 
receiving Gold Card. Going the 
other way, use NETRATE 19 
on the Gold Card and 
NETRATE 2 (faster than 
between QLs) on the 8 bit 
receiver. 

Details of the Flexynet 
commands, and a program to 
create the code, appeared in 


QL World last month, If 
you missed the issue, 
or would like the 
complete source, code 
and documentation on 
QL disk, plus extra files, 
write to DIY Toolkit at 
Cwm Gwen Hall, 
Pencader Dyfed, Cymru 
SA39 SHA, or call 0559 
384574, 

The Flexynet 
collection makes up 
Volume Y, one of a 
score of volumes 
based on the long- 
running DIY Tootkit 
series. Volumes cost 
three pounds each, 
with a processing 
charge of four pounds 
per order, so it pays to 
order several at once. 
Consult the December 
Quanta newsletter or 
send a stamped 
addressed envelope if 
you need more details 
of the volumes 
available. 


New thing 


This is the first DIY 
Toolkit project to make 
use of the ‘thing’ list, a 
late addition to the 
Qdos system variables. 
The Flexynet thing 
records the current 
network transmission 
and reception rates. 
You can keep track of 
i, and other such 
things, with Dario 
Leslie's forthcoming 
‘Qdos Interrogator or 
the ‘Thing Manager 
from Jochen Merz, 

QJump's QPTR 
environment includes 
special TRAPs to create 
and access things, but 
you cannot use these 
unless QPTR is loaded. 
The DIY Toolkit 
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DIY TOOLKIT FLEXYNET PART 2 - Copyright 1993 Simon N Goodwin. 


* 
* 
* NETREAD address, length 
* 
n 


et_read bsr find_thing2 
bne.s release 
lea.l net_input,ad 
move.w 4{ad),d2 
move.w a2,d3 
sub.w 2(a4),a3 


ble.s timeout 
* 
start moven,] 5/d7,-(a7) 
lea.l key_spec,a3 
moveq #17,da0 
trap #1 
movem.] (av}+,d5/a7 
and.b #8+64,d1 
beq.s no_key 
timeout moveq #-1,d0 
bra.s release 
no_key btst #net_inbit, (ad) 
beq.s5 start 
start_poll btst #net_inbit, (ad) 
bne.s start_poll 


* 
* Receive DS bytes from the port at 
* 


read_byte down_bit timeout 
up_bit timeout 
down_bit timeout 
up_bit timeout 
down_bit timeout2 
up_bit timeout2 
down_bit timeout2 
up_bit timeout2 
down_bit timeout2 


move .b d4,(a2)+ 

read_high 

subq.1 #1,05 

bne read_byte 
finished bra it_worked 
timeout2 bra timeout 


Look for Thing address 
Not found ~- give up! 
Point at the hardware 
Find slowest valid time 


Pick up 1 bit RX time 
Too short! 


Preserve length and TX_MODE 
Point at KEYROW(1}) command 
Fetch MT.IPCOM trap key 

This uses DO, D1, D5, D7, Ad 
ESC or SPACE bit set? 

Report not complete 


Wait for block start bit 
Loop till ESC or net busy 


Wait for a LOW level 


(AO) into memory at (A2) 


Store byte 
Stop bit, length ignored 


Extra exit: timing error 


* NETSEND - prepare to transmit bytes 
a 


net_send move.b do ,d6é 

bsr find_thing2 

bne release 

move .b d6,do 

move.w (a4) ,d6é 

swap a6 

move .w 

move.b do,di 

bset #snet_outbit,dl 

move.b dl,tx_control 

move. #6000,d2 
get_ready dbra d2,get_ready 
byte_loop move.b (a2)4+,d4 

move,.b di,tx_control 

move.1 d6,da3 
on_loop dbra d3,on_loop 

send_low 

send_high 

send_low 

send_high 

send_low 

send_high 

send_low 

send_high 

swap aj 

move.b 4d0,tx_control 
off_Loop dbra d3,o0ff_loop 

subq.1 #1,0a5 

bne byte_loop 

move.b di,tx_control 
last_bit dbra a6,last_bit 

move.b d0,tx_control 

bra it_worked 


{a4) ,d6 


* 


* NETRATE tx_time? , rx_timet , timeout? 
* 


set_rate movea.w $112.W,a2 


bne.s bad_param2 

trap #0 

movea.1 al,a2 

bar.s find_thing 

bne.s tidy_up 

move.w O(a2,a6.1),d1 

beq.s default_tx 

move.w dl,(ad) 
default_tx move.w 2(a2,a6.1),d1 

beq.s default rx 

move.w dl,2{a4)} 
default_rx move.w 4(a2,a6.1),d1 

beq.s tidy_up 

move .wW di,4(a4) 


tidy_up bra cheer_up 
bad_param2 moveq #-15,d0 

no_good rts 

* 

* valuet=NETVARS(index®) - read NET 
* 


Save 24-8302 TX mode 
Look for Thing address 


Restore 2X-8302 TX mode 
Pick up TX delay 

Even mark/space ratio 
DO is NET OFF pattern 
Di is NET ON pattern 
Activate net hardware 
Wait a while for sync 


Pick up data byte 
Send start pulse 


Send stop pulse 
Count down bytes 
Terminal bit 


De-activate network 


(0 means no change) 
Pick up CA.GTINT vector 


Continue only if DO=0 
Three parameters are needed 


Supervisor mode, fix A6 
Save the RI stack offset 


Check first parameter 


Store TX speed 


Store RX speed 


Store Timeout 
Revert to USER mode 


time constant 1, 2 etc. 


implementation emulates the 
standard format, using 
standard system calls that 
work on all QL roms, with or 
without QPTR. If you plan to 
put any new code in rom, 
where position-relative 
variables are impossible, these 
DIY thing routines will be right 
up your street. 

If you re-assemble the 
Flexynet code you will find one 
difference between the Listing 
and last month's hex code, 
The name of the Flexynet thing 
is now held in lower case, to 
suit existing thing managers 
which fail to recognise capitals. 
| did not discover this until after 
last column was submitted, 
Flexynet itself uses a case- 
insensitive search, so it can 
recognise names in capitals or 
small letters. 

The change from version 
1.08 to 1.09 means that the 
thing can be removed by a 
THNG REMY commana. If you 
would like this change, but do 
not wish to re-assemble the 
source, you can patch the 
name trom “FlexyNet" to 
“flexynet” with a utility like Spy 
or The Editor, 


The listing 


The accompanying listing 
completes the source for 
Flexynet version 1.09. It 
includes the important 
BYTE_LOOP and READ_BYTE 
routines that send and receive 
characters over the network. 

NETREAD waits for the 
network level to become high, 
polling the keyboard in case 
Esc or Space are pressed in 
the meantime. The MT.IPCOM 
trap and the list of parameters 
at KEYSPEC mimic the 
SuperBasic KEYROW 
command, retuming a value in 
D1. 

NETSEND starts by sending 
a relatively long pulse on the 
network. The constant #6000 
just before the GET_READY 
loop ensures that even a Gold 
Card will wait long enough to 
allow the original Sinclair rom 
and IPC to poll the keyboard 
for Esc without missing the 
start of the message. It 
corresponds to a delay of 
about 20 milliseconds on a 
slow QL which may take 5 
milliseconds to detect a key- 
press, 

A factor of four is enough to 
keep Gold Card and 68008 in 


@ 


step. It is hard to imagine that 
future systems will handle their 
keys any more slowly, QL 
KEYROW is a thousand times 
slower than the equivalent on 
machines with memory- 
mapped keys, like the ZX 
Spectrum. 

You can speed up the 
transfer of short messages by 
reducing this delay if you use 
Hermes and a recent version 
of Minerva, or all the 
processors on your network 
run at about the same speed. 
You may need to increase it if 
your processors differ in speed 
by a large factor, but Flexynet 
will need changes in any case 
if it is to run on a machine with 
a 68020 or later processor with 
cache memory. 


Timing 
The time-critical work is 


done by macros introduced 
last month. UP_BIT and 


~ DOWN_BIT wait for an 


appropriate change in the level 
at the net port, counting as 
they wait. A timeout error is 
reported if the count runs out 
before a change is sensed. 
Otherwise the loop count is 
compared with the limit in D3, 
and a one or zero bit is shifted 
into the least significant bit of 
D4. 


FLEAYTHET BIT PATTERHS 
2" 1 Lin. 
Mieiisei =e 

ae UL L$ 
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The first bit time is ignored, 
to ensure that the receive and 
transmit loops are 
synchronised. After the eighth 
data bit is received the byte is 
stored, then the READ_HIGH 
macro waits for a final ‘stop’ 
pulse. If the count of bytes 
remaining in D5 is not yet zero, 
Flexynet loops back to 
READ_BYTE to pick up the 
next 

Notice that some of the bit 
input macros take the 
TIMEOUT label as a 
parameter, while others use 
TIMEQUT2. In each case the 
effect is the same - Qdos 
reports ERR.NC - but both 
labels are used so that all the 
macros Can reach one or other 
label with a short (8 bit) branch 
offset. There would be no need 
for the second label if long (16 
bit) branches were used, but 
they would reduce the 
maximum input rate. 

SEND_LOW and 
SEND..HIGH macros in 
BYTE_LOOP generate timed 
pulses for NETSEND. The 
delay count for a bit value of 
one is twice that for a zero bit 
In fact the difference in length 
is slightly less, after accounting 
for the other instructions in the 
macro and the way DBRA 
counts down to -1, but one 
and zero bits are still easily 
distinguishable once the 


correct reception threshold is 
set 

The diagram shows the 
pattern of pulses 
corresponding to two byte 
values. Notice that it is the 
distance between the changes 
of level, rather than the level 
itself, that determines the value 
of each bit 


Easy Bit 


The code for NETRATE and 
NETVAR% is very straight- 
forward. They start by calling 
the CAGTINT vector to fetch 
integer parameters, obtaining a 
parameter count in D3. Once 
this has been checked they 
call FIND_THING to locate the 
Flexynet thing variables, and 
exit via TIDY UP if an error 
occurs. Supervisor mode is 
selected with TRAP #0, so 
other jobs cannot manipulate 
the thing list while Flexynet is 
using it 

NETRATE copies its three 
parameters into the thing 
variables addressed by Ad; if 
any parameter is zero the 
corresponding old value is left 
unchanged. NETVAR% 
doubles its parameter and 
uses it as an index into the 
table at Ad. The offset -2 
ensures that references to 
NETVAR%(1) refer to the first 
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word in the table. | here is no 
check on the value of D7, so 
NETVAR% can also read 
words from before or after the 
space currently used. 

The result from NETVAR% is 
moved to the space previously 
occupied by its parameter, so 
there is no need to check that 
extra stack space is available. 


The FND_THING subroutine 
looks through the thing list for 
the Flexynet thing. If it cannot 
be found it attempts to allocate 
iton the common heap, 
returning ERR.OM from 
MTALCHP if there is no spare 
memory. 

The Flexynet thing contains 
only six bytes of data, yet a 
further sixty bytes are needed 
to declare the thing in 
standard form. Many of these 
bytes can be left unset, as 
MTALCHP returns them, but 
others are set from the table 
labelled THING_SPEC. The 
default timing values are held 
in three words at THING_DATA, 
and could be patched to suit 
your hardware. 

| have started by developing 
a simple driver for the rather 
peculiar hardware of the 
standard QL | plan to develop 
that prototype into a fully 
fledged Qdos device driver, 
with variants for other 
machines. The aim is to get 
Flexynet working on all pairs of 
machines with fast enough 
memory, then add bells and 
whistles. 

Flexynet can expand into a 
Qdos device driver that lets 
standard commands read and 
write over the net in a device- 
independent manner. For the 
time being there are plenty of 
new ideas in this month's 
installment, and more to come 
in future columns. 

The 2X-8302 version of 
Flexynet works well, but it is 
just a start. Besides support for 
other ports and machines, 
potential extensions include 
device-independence, 
checksums, Handshaking and 
collision checks, faster data 
formats (eg RLL), automatic 
speed sensing and remote file 
serving. Please let me know 
how your systems perform, 
and what you would like to 
see next, care of QL World. 
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net_value movea.w $112.w,a2 
jsr (a2) e 
bne.s no_good 
subq.w #1,da3 
bne.s bad_param2 
move.w 0(al,a6.1),da7 
ble.s bad_param2 
add.w a7,da7 
trap #0 
bsr.s find_thing 
bne.s tidy_up 
movea.l $58{a6),al 


Pick up CA.GTINT vector 


Continue only if DO=0 
One parameter is needed 


Pick up parameter 

It must be greater than 0 
Form word index 
Supervisor mode, fix A6 


Oops; return DO error code 
Recover RI stack offset 


move.w -2(a4,d7.w) ,O(al,a6.1) 


moveq #3,da4 
bra.s tidy_up 
* 
* Locate the FlexyNet Thing; create 
* 
find_thing moveg #0,d0 
trap #1 
find_thing2 movea.1] a0,a4 


Return an integer 


it if necessary 
MT.INF trap key 


A4 -> System variables 


lea.l sv_thingl(a4),a5 


lea.l thing_name,a0 

suba.1 a6,a0 

movea.w $e6.w,a3 
next_thing move.1 (a5) ,a0 

beq.s make_thing 

movea.l d0,a5 

lea.l 42(a5),al 

suba.1 a6,al 

moveq #1,d0 


jsr (a3) 

tst.1 do 

bne.s next_thing 
got_thing lea.1° 60(a5),a4 

rts 


* 

make_thing moveq #24,da0 
moveq #60+6,d1 
moveq #0,a2 
movea.l a2,a5 


trap #1 

movea.l1 a5,a2 
tst.1 do 

bne.s done_thing 


lea.1 52(a0),a5 
move.1 a5,16(a0) 
lea.1 thing_spec,a5 
lea.l 38(a0),a3 


AO -> required name 
Make it relative 
Preset UT.CSTR vector 
Check list pointer 
End of list found? 
A5 -> Thing base 
Point at its text 
All is relative... 
Ignore letter case 
Call UT.CSTR 

Do names match? 


A4 -> Thing values 
Return OK, DO=0, Z set 


MT.ALCHP trap key 

Total space required 
Owner is SuperBASIC 
Save A2 (SEND/READ base) 


Restore A2 

Did ALCHP work? 

If not, return NZ error code 
Point at Thing data values 
Set pointer to Thing values 
Point at ASCII header 

Point at destination 


moveg #(thing_end-thing_spec) /2-1,dl 


set_header move.w (a5)+, (a3)+ 
dbra di,set_header 


Copy one header word 
Initialise the rest 


lea.l sv_thingl(a4),a5 


move.1 (a5) ,(a0) 
move.1 a0,(a5) 
lea.l 60(a0),a4 
moveq #0,da0 
done_thing rts 
* 


thing_spec dc.b £1.09" 
thing_name dc.w 8 
dc.b *flexynet’ 
dc.b *THGS/ 
dc.l a 
thing_data dc.w 5,3,127 
thing_end 
* 
key_spec dc.b $,1,0;,:0,0,0,1,2 
* 
define dc.w 5 
dc.w send_bits-* 
dc.b 7,*NETSEND’ 
dc.w netbeep-* 
dc.b 7,‘NETBEEP’ 
dc.w netpoll-* 
dc.b 7,’NETPOLL’ 
dc.w read_bits-* 
dc.b 7,*NETREAD’ 
dc.w set_rate-* 
dac.b 7,'NETRATE’ 
dc.w 0,2 
dc.w net_value-* 
dc.b 7,'NETVARS‘ 
dc.w 0 


end 


Extend the linked list 
Update the list start 
Make A4 -> Thing’s values 
Set Z flag; ERR.OK 


Version number 

Name length 

Thing name 

Shared data follows 
TX, RX, & Limit times 
KEYROW(1) IPC message 


Number of procedures 


End procedures, one FN 


End of functions 


a eee OO 


lan Bruntlett 
explains a 
significant 
upgrade to QL 
usability. 


POINTER 


ENVIRONMENT 


his article describes, 

explains and 

demonstrates the 

Pointer Environment 

while assuming only a 
little QL knowledge. 

In the future | will cover Qpac2 
and other things there are no 
room for here. Some 
explanations are in the 
Appendices at the end of this 
article. Inexperienced users may 
wish to refer to the appendices 
while they are still gaining their 
“QLlegs”. 

lf you know next to nothing 
about the QL | suggest you 
browse through the @é User 
Guide (don't worry if you don't 
understand it) and gossip with 
some people who know about 
computers - you may pick 
something up. See Appendix 
“Commands you'll find useful" for 
the SuperBasic commands to 
use when taming your QL in the 
future. 


Meetings 


A good source of QL people 
is a local Quanta meeting. Non- 
members are often welcome, 
and you will find out more about 
Quanta and your QL 

The novice QL user is likely to 
get more from attending Quanta 
meetings than most people. 
Most of a novice users 
problems will have been 
experienced and solved by the 
people there, so don't be afraid 
to ask questions. No-one in 
computing knows everything - 
be wary of people who reckon 
they do. 

The QL uses the Qdos 
operating system and its 
SuperBasic interpreter and 
(when new) comes bundled with 
the four Psion programs - Qu/// 
Archive, Abacus, Ease\ and 
(sometimes) a games microdrive 
cartridge. No disk drives, printers 
or extra software were ever 
supplied with the standard set- 
up by Sinclair. 

This presents some 


@ 


interesting problems. You can 
do plenty of useful work on an 
unexpanded QL with just the 
Psion programs, but this does 
not do the machine justice. 


Disk drives 


Disk drives are faster than 
microdrive cartridges, more 
reliable and, when storing large 
amounts of information, much 
cheaper. A floppy disk costing 
less than 50p holds 720 
kilobytes (KB) of information 
while a microdrive cartridge 
holds just over 100KB and costs 
about £2. In real terms, when 
you fill a single disk with 
information it is at least £10 
cheaper than storing the same 
amount of information on 
microdrive cartridges. It is worth 
having a pair of reliable disk 
drives - cheap, unreliable disk 
drives are not worth the trouble 
they cause. 

Additional memory allows you 
to edit longer documents with 
greater ease and have more 
than one program in memory. A 
unique feature of Qdos is that it 


INSERT 
Horne | 


uses “free/spare memory" to 
speed up file access, 
remembering the contents of 
files it has recently handled. 

On my Gold Card QL with 
plenty of free memory (1252KB 
at the moment, file handling 
can almost be too fast This 
happened when | was 
converting some C68 manuals 
into DataDesign files. The 
manuals were converted from 
Quill documents to text files and 
saved on my slow 5.25-in drive. 
A small SuperBasic program 
read the work files and 
produced a DataDesign 
database. The text files had to 
be edited and re-saved 
occasionally because the 
SuperBasic program sometimes 
became confused. So a loop of 
“write text file”, “process text file", 
“find a problem’, “fix it” and go 
back to “write text file” started. 
This was faster on a Gold Card 
because when “write text file” 
was done, Qdos had enough 
free/spare memory to keep a 
copy of the text file in memory. 
When the “process text file” 
started, Qdos checked that the 
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QUIT HELP 4 
-_ “Files 
Jobs 
Channe !s 
Print 
Window dump 
Options _ | 
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disk had not been changed and 
just used the memory-based 
copy of the text file. This process 
of keeping copies of files in free 
memory without any 
involvement of the user is called 
“slaving” in the QZ 7ecAnica/ 
Guide. 

This tactic of the QL may 
seem like common sense but 
no other operating system does 
this as well as Qdos - other 
operating systems insist on 
having a fixed amount of 
memory for buffering. | use an 
improvement of Qdos, Minerva, 
which has given me no 
problems with Gold Card - it has 
been said that the Sinclair 
versions of Qdos don't take as 
much advantage of the Gold 
Card as Minerva. | have no 
intention of messing about with 
a Trump Card and a Sinclair 
version of Qdos to verify this. 


Hardware 


Back to the Pointer 
Environment This needs a QL 
with at least 384KB of memory, 
a monitor, power supply and a 


no None 
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copy of a program called 
‘ptrgen’, What an anti-climax! 
After the last paragraph you 
were beginning to think you'd 
need a second mortgage to 
afford all the kit 


This is where a computer can 
have more than one program in 
memory and split its working 
time between the different 
programs (jobs). A bit like a 
secretary answering a phone, 
writing a memo using a word- 
processor, drinking coffee and 
chatting with a friend. 

The QL's multitasking does 
not have ‘Virtual machine” 
protection so if a pregram 
crashes, it can affect all the 
programs in your computer - the 
equivalent of the secretary 
swearing at a telephone caller 
instead of the photocopier and 
dropping the coffee on the word 
processor. “Virtual machine" 
protection on a micro-computer 
is very unusual - OS/2 on a 
486/386 PC has it but Qdos has 
yet to take advantage of the 
68030 or 68040 where virtual 
machines may be possible. 

This lack of protection really is 
as drastic as it seems. When 
working with a computer you 
should save data regularly, 
make sure you have at least one 
back-up and gently introduce 
new software into your work. 

It is NO good to take an 
isolationist point of view with 
software, buying some software, 
getting that working and sticking 
with that permanently. Ignoring 
the rest of the world put the 
Chinese Empire at a 
disadvantage, so don't make the 
same mistake. Try to be aware 
of what is on offer and get 
friends to show you new 
programs they have bought 


Window-wipe 


Before the Pointer 
Environment was introduced, the 
QL had “destructive windows”, 
When multi-tasking, the user 
would swap from one program 
to another and would usually 
press a key (F4 or Shift-F5) to get 
the program to re-draw its 
screen, Unfortunately this would 
demolish the displays of the 
other programs. The result was a 
mess, but it worked and was 
economical with memory. The 
QL would multi-task and the 


user wouid just have to wait tor 
the screen to be re-drawn. This 
mutually assured screen 
destruction worked as long as 
each program could re-draw its 
windows and had an active 
cursor. Many programs couldn't 
re-draw their windows, and 
many didn't have an active 
cursor. Those programs that 
didn't have an active cursor 
could sometimes “lock out’ the 
user when involved in multi- 
tasking. 

This state of affairs could not 
go on forever. It is easy enough 
to re-draw the screen of a word- 
processor but very inconvenient 
to re-draw that of a Fractal 
Generation program just 
because something else has 
corrupted its display. 

The Pointer Environment 
improves the QL’s handling of 
the screen so that windows are 
preserved automatically. This 
was not done when the QL was 
first brought out because there 
wasn't enough memory inside 
an unexpanded QL and 
expansion memory was 
expensive (Roughly £1 per KB - 
at those prices Trump Card 
would be £900-plus, instead of 
£95 plus P&P from Qubbesoft 
PD). 


The Pointer 


The Pointer Environment was 
introduced in 1987 with Qjump's 
Qram (Figure one), a software 
package intended to take 
advantage of expanded QLs. 
The Pointer Environment 
stopped programs from over- 
writing each others windows 
and added the use of a pointer 
device (usually a mouse) at a 
time when mice were becoming 
very popular on other machines. 

Because most the mouse 
supply to QLs was still limited, 
the Pointer Environment was 
written to be used with either a 
mouse, or the keyboard, or both, 
Try using Microsoft Windows on 
a PC or Open-Windows on a 
Sun work-station without a 
mouse and you will appreciates 
that this “mouse independence” 
is no mean feat (7He man 
speaks true, say Mac and PC 
users, On some systems, if your 
mouse breaks down the whole 
system is virtually useless. 

The Pointer Environment had 
some other facilities for Qram - it 
introduced standard routines for 
handling images. Little symbols 
could be defined as sprites and 
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put on the screen without the 
programmer having to think 
about how the data should be 
created (sprite editors are 
available) or how to display the 
image. The “Qjump" logo on the 
Qram menu is a sprite. This is 
different from other computers 
which usually have sprites flying 
all over the screen, changing 
colours and blasting each other 
to pieces. The Pointer 
Environment sprites (apart from 
the cursor sprite) don't move, 

The “pointer in pointer 
environment refers to the cursor 
sprite which the user can move 
about the screen using a mouse 
or the keyboard. The shape of 
the pointer sprite/picture actually 
changes according to the state 
of your QL (Figures two and 
three). If! move my QIMI mouse 
while typing this article into 
text87, a picture of a “K” appears, 
telling me that the program 
underneath the pointer is 
waiting for keyboard input If the 
pointer sprite was a red “no- 
entry” sign then it would mean 
that the program under the 
pointer does not want any 
keyboard input 


Compatibility 


lf a piece of software is 
described as “incompatible with 
Qram”, you can be sure that it is 
conflicting with ‘ptr.gen’ from the 
Pointer Environment The conflict 
is Sometimes blamed on the 
Window Manager. ‘wman’. This 
iS Nonsense. 

In the Pointer Environment, 
‘ptr_gen’ is the active partner, 
extending the system. The 
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‘Window 
manager is a set 
of routines for 
handling a 
consistent 
window/pointer- 
based interface 
that uses 'ptr_gen’ 
to handle the 
mouse pointer, 
keyboard, 
preserving 
windows and 
drawing sprites. 
The Window 
Manager only 
manages 
individual 
windows, telling 
the programmer 
what the user is 
doing - all the 
nitty-gritty is done 
by ‘ptr_ger’. 


Technical 


Qjump used the Window 
Manager to give a mouse-driven 
interface for Qram. So that other 
programmers could use the 
Pointer Interface and Window 
Manager routines, Qjump 
produced Qor As a reference 
guide to ‘ptr.gen’ and ‘wman,, 
Qptr is good. if you know about 
what you want and where you 
will find it, the Qptr manual will 
be very easy to use, For 
someone who is learning 
something new about Pointer 
programs, Qptr is a complicated 
manual that pushes you back 
on your own resources. Qptr 
provided some complete 
programs as examples (a sprite 
editor, a paint program, and a 
‘demo. 

A Utopian Qptr would also 
have had many small examples 
with explanations. Each demo 
could have shown an individual 
aspect of either the Pointer 
Interface or the Window 
Manager. Qmon would have 
been updated to help when 
debugging Pointer programs. 

For years | laboured under the 
idea that the Window Manager 
made life hard for the 
programmer to make life easier 
for the user. Now, | am being 
told that inexperienced users are 
finding pointer-driven 
applications hard to get started 
on. The Window Manager is 
responsible for drawing the 
mouse-driven windows of most 
Pointer Environment 
applications. It is possible to 
bypass the Window Manager 
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and call the ‘ptr_ger’ routines 
directly with TRAP calls but you 
will have to wait until another 
episode for examples. 


Demonstrating 


Assuming that you have a 
disk drive, QL with at least 
384KB of memory, 7oo/Ait 2 and 
a pointer program, | will give a 
brief demo of a selection of 
pointer programs (Qa, Qpac?/, 
Quanta library). Commands to 
be typed in will be in italics. 

| have tried to keep this as 
simple as possible so do not be 
upset if you think | am talking 
down to you. Great care is being 
taken to keep this article 
accessible to comparative 
novices, 

In the QL, most jobs have 
windows. When the Pointer 
Environment is installed, it is 
possible to move from one job's 
windows to another by pressing 
Ctrl-C, 

When using a QIMI mouse 
(the QIMI interface and mouse is 
now available from Quanta), it is 
possible to select a job by 
moving the pointer (via the 
mouse) from the current window 
to another job's windows and 
pressing the Left mouse button. 
QIMI is the best interface for this 
as it can move the pointer even 
if Qui is being used. 

There is a serial mouse 
interface available which 
supports the use of the third 
(Middle) button, This usually acts 
as Quit/Escape. When pressed 
simultaneously with the Left 
button, it emulates “Wake”. When 
pressed simultaneously with 
Right button, it emulates “Sleep” 


Key and Mouse 


The QL's keyboard can 
emulate its mouse quite well - 
the cursor keys will move the 
pointer arrow and the mouse 
buttons are emulated by the 
Space bar (Left button) and 
Enter (Right button). The pointer 
environment, from version 1.23 
of ptr.gen onwards, has 
commands to allow cursor key 
movement of the pointer to be 
disabled (CKEYOFF) and re- 
enabled (CKEYON). 

if you are using the Pointer 
Environment without a mouse, 
then the pointer can be moved 
to another window with the 
cursor keys. To select a job 
under these conditions, just 
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move the pointer over the 
desired job's windows and 
press Space. If you are in Quill 
or some other text-related 
program, the cursor keys are 
used for moving around a 
document So you use Ctrl-C to 
switch from one program to 
another until you reach the right 
one. 

lf you look at the various 
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screen dumps of pointer 
programs you should notice 
similarities. They have a title, a 
scattering of options at the top 
of the window and (usually) a 
display specific to the task in 
hand - a list of files, a list of jobs, 
etc. 

Referring to Figure one, the 
“Quit’, “Help” and “picture of two 
little squares” options may be 
selected by moving the pointer 
over them, When the pointer 
moves over an option, that 
option becomes the “current 
option”. The “current option”, if 
any, will be outlined in either 
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black or white. Selected options 
that affect the status of a 
program (eg Sound On ina 
game) appear in a different 
colour, according to their status 
On/Off, etc. If an option is 
unavailable then this will usually 
appear in a subdued colour and 
you will not be able to select it 


Subtle 


Pointer programs handle their 
options in a very subtle way. The 


Qram manual gives good 
guidance on these points. 


To Do something from a 
menu: 

A “do” is achieved by hitting 
the Enter key or Right mouse 
button. A “do” will select an 
option, and usually invoke any 
associated function, such as file 
copy. A “do” on an option may 
also be put into 
action by typing a 
single character, 
usually the first 
letter (Such as J 
for JOBS), or an 
under-scored 
letter (Such as N 
for “Save with 
New name’). 
QUIT breaks this 
rule by using 
ESCape. Some 
options may not 
have this feature - 
filenames and the Format option 
are examples. (From the Qram 
Files menu. 


To change the status of 
an option: 

A ‘hit’ on an option is 
achieved by moving the pointer 
to the option using the mouse 
or the cursor keys, and pressing 
Space or the Left mouse button. 
A hit will toggle an option’s 
status between available and 
selected. 


The above definitions are best 
used when playing around with 
a pointer 
program. The 
difference © 
between a Hit 
and a Do is 
important, but 
don't try to learn it 
by rote. Just get 
used to the 
Pointer 
Environment and 
you will “learn” it 
naturally. 

The Sleep and 
Wake/Update options are not 
supported by all Pointer 
programs. They were introduced 
to users when Qoac2 was 
launched. See Figure six for 
the Sleep and Wake symbols. 


To put 2 job to sleep 

Press Cti-FT or Hit the ‘Zzz" 
symbo/ (see Figure six). This 
hides the job's windows and it is 
stopped. A button appears in 
the button frame with the 
program's name. The button 


frame is specific to Qpace and 
will be explained, with Qpacz, 
later in the series. 


To update a window (Wake) 

Press Ctt-F2 or Hit the 
yagged lightning strike” symbol 
(see Figure six). The windows 
will be brought up to date. This 
would be used in a jobs menu, 
for instance, to update its jobs 
list if the user had quit some of 
the programs and returned to 
the jobs menu. 


7o Resize a job's windows 

This option has been 
supported since Qpac1 came 
out (See Figure four, “Re-size 
window’). Press Ci7-F3. 
Programs handle re-sizing of 
windows in three different ways. 
(Most QL programs ignore 
requests to change the window 
size) 

Many Pointer programs will 
change the pointer arrow to a 
Bizarre Looking Blob (BLB) when 
changing the window size. The 
pointer moves to a new pant of 
the screen and the new window 
size follows the pointer position 
(a process widely known as 
“dragging’). If you move the 
pointer to a new position above 
the old position, for instance, the 
window will be taller. If the 
pointer is moves to the left of the 
old position, the window is 
wider. If you move inwards or 
down, the window will be 
smaller. 

Other Pointer programs, in 
particular the Qoac7 Ca/endar, 
have a distinct set of window 
formats. Telling this kind of 
program to re-size its windows 
will result in the next window 
format in the cycle being 
displayed. The Qpac1 Calendar 
goes from a medium sized 
Calendar (displaying Clock and 
Month) to a large sized calendar 
(displaying Clock, Month and 
extra displacement info) to a tiny 
clock, not showing the days of 
the month at all. 


To Move a job’s windows 

This option has nearly always 
been supported (see Figure four, 
“Move Window’). Press Cir-F4. 
The pointer will change into a 
“double block” symbol. Afowing 
the pointer and pressing Hit, Do 
or Escape will move the window 
to the pointers current position. 
It is possible that Escape will 
one day abort the move window 
option, so don't get into the 
habit of using it to complete a 
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Freezing the display 

This is available without the 
Painter Environment Fress Ct77/- 
F®, \t delays any attempt to print 
anything on the screen until Ctrl- 
F5 or another key is pressed. 

If the Pointer arrow is visible 
when Ctr-F5 is pressed then the 
pointer will turn into a padlock 
(See Figure two, “locked 
window’). 


Preparing for the demo 


Switch on your QL, 

Press F1/F2 according to your 
display type 

If you pressed F2 type in the 
command MODE.4 and press 
Enter 

Put the appropriate disk in 
disk drive one. 


DEMO 1: With Qram 


TK2_ EXT 

DATA USE FLP1 
PROG_USE FLP1_ 
LRESPR FLP1_Boot_REXT 


This loads PTR_GEN, WMAN 
and Qram itself 


Press the Alt key and / 
simultaneously, and you 
should get the Qram menu, a 
little rectangle, appearing on 
the screen (Figure one). There 
should be a little arrow on 
screen (the Pointer) which you 
can move around with a 
mouse or the cursor keys. 
When the pointer moves over 
an option that can be selected, 
the option is highlighted with a 


Psion 


To multi-task Psion programs 
with Qram, you need to process 
your copy of Quill, etc, with the 
program Grabber Simply put 
your Qram disk in drive one, 
enter the command EX 
FLP1_GRABBER, then put your 
Quill disk in drive two. Follow the 
instructions on Page 19 of the 
Qram manual. They worked for 
my Asion XChange a long time 
ago. Grabber will modify Quill so 
it will behave itself properly. If 
you save the new Quill to 
FLP1_GRQUILL then EXEC, 
FLP1_GRQUILL will run your 
new Quill. This process can be 
applied to Abacus, Archive and 
Easel. The “Grabbea" copies of 
the Psion programs cannot be 
configured with the Psion 
CONAIG program but there is a 
program by Rich Mellor, 
“CONFIGURE”, that will - it is on 
the Quanta library disk PSION_1. 
| am unable to verify that 
“CONFIGURE” works as my 
copy of PSION_1 seems to have 
disappeared! 

The Qram program 
HOT_MAKE will set up a file of 
programs that can be resident in 
memory and called up with a 
Hotkey. Simply put the Qram 
disk in FLP1_ and foliow the 
instructions. It cannot put normal 
SuperBasic programs on a 
hotkey but it can put most QL 
jobs (started with an EXEC or EX 
command) on a hotkey. 


Having the Psion programs 
behaving themselves and 
running from a hotkey is fine, but 
why not have them 
automatically LOAD or have 
them in memory all the time? it 
is possible to do all this with the 
Hotkey System Two (hot_rext). 
This was developed as the 
successor to Qram's 
HOT_MAKE and is much more 
flexible. 

Qram is now obsolete - when 
Qram was replaced by Qpac2, 
old Qram users were allowed a 
discount when upgrading to 
Qpac2. But Qram had a few 
facilities that Qpac2 doesnt - it 
had a screen dump menu and 
the ability to automatically 
configure itself Qpac2 has many 
things that Qram does not have 
and there are ways for a Qpac2 
user to get round the missing 
facilities. See the Qpac2 demo 
in a subsequent article for more 
details. 


DEMO 2: With QPac1 


Qpaci introduced the Hotkey 
System Two, a new CONFIG 
program and a set of six utilities 
(Calendar, Clock, Alarm Clock, 
Calculator and System Monitor). 
Because Qpac1 offers more 
flexibility, it is easy to be 
overwhelmed by the choices 
when trying to create a 
convenient boot disk for the first 
time. 


Using the QPAC1 utilities 


TK2_EXT 

Put a copy of the QPAC1 
disk in disk drive one. 
LRUN fip1_Boot 


After booting from a copy of 
the Qpaci disk, press He keys 
Att and c together You should 
get the Qpac1 calculator to 
“pop-up”. Press A/t-& The 
calendar should pop up. There 
should be a little arrow on 
screen (the Pointer), which you 
can move with a mouse or the 
cursor keys. When the pointer 
moves over an option that can 
be selected, the option is 
highlighted with (usually) box 
this is the “current item”. 

Move the pointer over the 
screen using the cursor keys. 
When the pointer becomes a 
padlock, the window below is 
“locked”. To un-bury it, move the 
pointer to the locked window 
and Hit it by pressing Space or 
the Left mouse button. If the 
Calendar or the Calculator 
overlap each others windows, 
you will need to Hit the 
overlapped program (either 
Calendar or Calculator) before 
you can use it You can shift the 
windows. Moving the pointer 
arrow over the “double box" 
symbol (See Aigure four, “move 
window’) and Hitting it changes 
the pointer arrow to a “double 
box". Move the pointer to where 
you want the window and press 


little white box. Qjump's an 
manual! calls this the “current 
item" {page 9). 

Move the pointer around the 
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window below the pointer is > 3 RUB 
“locked” because it is buried by 
another window, in our case 
Qram's window. A locked 
window cannot be updated until 
it is unlocked, usually by “un- 
burying” (exhuming?) its 
windows. To do this, s7ove the 
pointer to the locked window 
and Hit it by pressing Space or 
the Left mouse bution. The 
selected job will be brought to 
the top of the pile of windows 
and any keypresses will be sent 
to it 
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Total Memory 1928k 
Free Memory 887 kK 
Jobe Running 9 
Open Channels 27 
Het Station 21 
Gdos Version 1.33 
Ptr Interface 1.43 
Wen Yersion 1.54 
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Space or Lett mouse. Now you 
will be able to go from the 
Calculator to the Calendar and 
back again, without having to 
“un-bury" windows. 


Be thorough 


The Qpac! manual covers the 
use of the Qpac1 utilities well. 
Do not be fooled by its brevity, 
go through each section, or you 
will miss something useful. 


Config 


The Config program is a 
“universal” configuration 
program. Most Pointer-driven 
programs use this program to 
CONFiGure themselves. The 
advantage is that only one 
program is required to CONFIG 
many programs. Programmers 
can incorporate “config” blocks 
in their programs instead of 
writing a config program for 
each program they write, saving 
time. Users only need to handle 
one config program, so they 
have fewer programs to learn 
and keep on disk, 

Type EX flot_ CONFIG to run 
Config. The prompt “Give the 
name of the next file to be 
configured or press ESC to quit 
the program” will appear. If 
Config has a flashing cursor 
next to the prompt then it is 
waiting for keyboard entry of the 
filename - type in flp1 calculator 
and press Enter, 

The later versions of config 
use the ‘menus’ extensions if 
they are present If the prompt 
doesn't have a flashing cursor 
next to it, you should see a large 
window with the title “Select 
Filename”. This is the “File 
Select’ menu by Jochen Merz. 
See the Appendix “Using File 
Select” for full details. 

The question “Configure 
Calculator version etc (Y, N or 
ESC)’ appears. Press ¥ Then the 
question “Prioritised or 
immediate calculation?” 
appears, Space will toggle 
between “Prioritised” and 
‘Immediate’, Enter sets the 
current choice. 

Then we are asked where the 
configured calculator is going to 
be saved. The cursor is at the 
start of the filename 
{flp1_calculator) and this may be 
edited to save Calculator with a 
different name. If you attempt to 
save the configured calculator 
over the old one then approval 
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is asked “Hie exists, OK to 
overwrite?”. If you change your 
mind about the choices you 
made during the configuration 
then pressing Escape will 
abandon the configuration 
changes. 


Rebooting 


Common sense would 
suggest that once a file has 
been configured and saved, the 
changes made with Config will 
take effect immediately. If a 
resident program (a toolkit, 
system extension or job that has 
been HOT_RESed or 
HOT_CHPed) has been 
configured and saved then 
nothing will take effect until the 
QL is re-booted. 

The only way to configure a 
resident program without the 
need for re-booting is to 
configure it, remove the old 
version from memory and load 
the new version into memory. 
This is not usually practical so 
most people tend to reset their 
QL instead. 

As usual, if you find a newer 
version of Config when you get 
a new Pointer program, use that 
instead of your old version. It 
may be a good idea to put the 
newest Config on your Boot 
disk The very early versions of 
Config had bugs, and the later 
versions have extra features. 

Config’s biggest disadvantage 
for the user is that there is no 
“update” option - given an old 
configured file and its new, un- 
configured replacement file, 
Config won't configure the 
replacement file automatically 
with the information present in 
the old configured file. 

The drawback for 
programmers is that Config is 
mainly for assembly language. 
Oliver Fink wrote a program to 
incorporate Config information in 
SuperBasic programs compiled 
by Qliberator (see Quanta disk 
SPECIALS_4) It is possible to 
write “action routines" to perform 
the configuration if the standard 
behaviour of Config is not 
enough. Unfortunately they have 
to be written in assembler. It 
would have made life so much 
easier if they could have been 
Qliberated SuperBasic as well. 


Integrating Qpacl 


Integrating Qpact into your 
existing set-up can be very easy 


Wake up! 


or very hard. If you already use 
the Pointer Environment and 
Hotkey Two then integrating 
Qpac1 is merely a matter of 
deciding how you want the 
Qpac1 jobs to be invoked. You 
need to decide whether they 
should be loaded from disk 
when needed, or made resident 
when Booting. Making the 
programs resident uses more 
memory but is convenient, 
especially if you don't have a 
hard disk 

The people who will find 
integrating Qpact hard are 
those who don't use the Pointer 
Environment and don't know 
much about SuperBasic. Some 
of their programs will clash with 
the Pointer Environment and 
they will be faced with an 
alarming case of culture-shock. 
lf you use some old QL software 
with a “swapper’ type of 
program, your best course of 
action is to get an experienced 
person to help you. 


This section refers to certain 
“Hotkey” commands (prefixed by 
a HOT_) refer to the appendix 
“Hotkeys” for brief definitions. 

A simple way of having your 
Hotkey programs set up is to 
HOT_RES them - whenever the 
Hotkey is pressed, a new job will 
be created. No additional 
memory will be used for the 
program code but memory will 
be used for the job’s data-space 
and its screen image. Also, your 
computer can become Cluttered 
if you have a lot of jobs in 
memory. This wastes a lot of the 
flexibility of the Hotkey Two. 

A better way is to use the 
Hotkey Two to start a new job 
only if it is needed. Consider 
Qpact's calculator - to pop-up a 
new Calculator job every time | 
pressed AIt-C, | would set it up 
with the command: 


Go to sleep 


70 ERT HOT _RES(C: 
¥o1_calculator) 


Normally | would only ever 
need one calculator running at a 
time so | could set it up on a 
hotkey with: 


70 ERT HOT_REST(C; 
ffot_calculator) 


When this statement is 
executed (usually) in the Boot 
program, it loads the calculator 
into memory and links itin as a 
“Thing”. It also tells the Hotkey 
system that when AIt-C is 
pressed, it is to look for a 
calculator job - if it already exists 
then it is to display the 
calculators windows (Pick it} 
instead of creating a new 
calculator job. 

None of the above methods 
are good enough for me. | prefer 
to have my cake and eat it So | 
define two hotkeys to deal with 
the same program. 


70 ERT HOT_AES(C; 
tot _calcutator) :REMark 
make resident & set key 
75 ERT HOT_WAKE(C; 
calculator) :REMaik set 
another key for ca/culator 


| press Alt-c to run a calculator 
and Alt-Shift-c to run a new copy 
of calculator. | manage to 
remember which key does what 
by using the Alt-Shift-key 
combination to perform various 
things (HOT_LOAD, HOT_RES) 
and the normal Alt-key 
combination to run the program 
“normally”. The above sequence 
of commands will work if | want 
the program to be resident, but 
what if | wanted the program to 
be loaded from disk? | would 
use these commands: 
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70 ERT HOT_LOALNC; 
4o1_catculator) 

75 ERT HOTLOADI(C; 
calculator) 


The calculator would be 
loaded from disk when needed - 
each time Alt-c or Alt-C is 
loaded, a new calculator would 
be loaded from disk If it is likely 
that many calculator jobs will be 
running at any one time then a 
HOT_RESed calculator would 
be more economical in its use 
of memory. The HOT_LOAD 
routine is ideal for making 
hotkeys for programs that are 
only run occasionally. 

People who are determined to 
build a Qpac1 boot should refer 
to the Appendix ‘Bui/oing a Ol 
boot program” and “Hotkeys* 


DEMO 3: Pointer Software 

This demo needs two disks 
from the Quanta library, 
‘SPECIALS_0' and ‘UTILS_GEN4’. 
Put SPECIALS_0 in fip1_. 


7K2_EXT 
LRESPA tip? _PTR_GEN 
LRESPR fp WMAN 


This loads an old copy of the 
Pointer Environment Some 
Pointer programs may refuse to 
run with it saying “Pointer 
Interface too old". 

The disk UTILS_GEN4 has a 
selection of pointer programs. |'ll 
deal with HEXC, VIEW, CHAR 
and INFO. Figure five is a 
screen dump of HEXC, VIEW, 
CHAR and INFO in action. Put 
UTILS_GEN4 in flp1_. Type: 


EX tpt _HEXC_exe:EX 
fipt_INFO_exe 


You should get a display 
giving system information - the 
amount of free memory, network 
station number, various version 
numbers (be careful, my copy 
gets the version numbers of the 
Pointer Interface and the 
Window Manager mixed up, its 
easy to miss - Dick Copland 
spotted this one). 

There should be a little arrow 
on screen (the Pointer), When 
the pointer moves over an 
option that can be selected, the 
option is highlighted with a 
white -box - this is the “current 
item’. Move the pointer over the 
screen using the cursor keys. 
When it is a padlock, the 
window below it “locked” as 
before. 

The INFO program has buried 


the windows of HEXU, the 
hex/decimal/binary calculator 
(Hexcalc). Press Space and the 
pointer arrow will turn into a 
“double box" symbol to move a 
window. Move the pointer away 
to the far side of the screen and 
press Space or Left mouse 
button. This behaviour of INFO is 
not standard. The key-press for 
move-window is usually Ctrl-F4. 
You should be able to see the 
Hexcalc window and the 
‘System Information” window 
(Figure five). 

Having moved the windows 
so they don't overlap, move the 
Pointer to the Hexcalc window 
and press Ctrl-F4 or Hit the 
“double box" option for “move 
window". Move Hexcalc so its 
windows are only just 
overlapping System 
Information's windows. Move the 
Pointer over System 
information's windows - it should 
change to a padiock Press 
Space or Left button and 
Hexcaic’s windows will be 
“unburied” covering System 
Information’s windows. If System 
Information or the Hex 
Calculator jobs overlap each 
others windows, you will need to 
Hit the overlapped program 
before you can use it 

Press Ctrl-C until you reach 
SuperBasic and type in the 
command: 


EX fo? VIEW 


So far, in all these demos, the 
pointer is normally an arrow. The 
View program provides a 
custom pointer, a “hand” symbol. 
This is shown in Figure five. 
When the Pointer is over the 
View window, it turns into a 
hand. Press Ctrl-C to get another 
program on screen. Move the 
pointer over its windows. You 
should find that the pointer is 
again an arrow in the other 
program. View is a simple 
program - simply give it a file 
name and it will display the file 
in its windows, waiting for you to 
ask for more. As View does not 
read the whole file into memory 
{it opens a channel to the file 
and reads information when it is 
required), you should not 
remove a disk that has a file you 
are VIEWing. Any attempts to 
read a bit more of the file by the 
View program will fail. Any 
attempt by other programs to 
use other disks in the same 
drive will fail with the error 
message “Files still open" and 
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“not tound”. Wrap is the only 
obscure option in View - see the 
Appendix Wewing files on your 
QL"for Wrap On and Wrap Off. 


Play around 


Play around with the pointer 
programs. A Pointer Environment 
manual isn't provided with these 
Quanta disks - experiment and 
use this article for information. 
You wont be able to define 
hotkeys, as ‘hot_rext isn't in the 
Quanta library, but the other 
Pointer programs will be 
avallable. 


THE 
APPENDICES 


Viewing files on your QL 


If you have Qram then pop-up 
the Qram menu and select/Hit 
Files. Then select/Hit any files 
you want to view and Do View 
(press V). Pressing “N” for “Next” 
will move to the next file if you 
selected more than one file to 
view. 

lf you have Qpac2 then pop- 
up the Files menu. Then 
select/Hit any files you want to 
view, press F4 and Do on the 
name of a file you want to view. 
Pressing ‘<’ or ‘>’ will move to 
“previous” and “next” files if you 
selected more than one file to 
view. 

lf you have 7oo/k/t Two then 
the View command will show 
files in a SuperBasic window but 
long lines will be not be shown 
in full - only the part that fits on a 
single row will be displayed, the 
extra characters ignored by 
View. This is equivalent to 
having Wrap Off when viewing 
files in Qram or menu_rext's 
VIEW_FILE This explains why 
VIEWing a Quill document does 
not show the full file on screen. 

Toolkit Two can View files, 
with the equivalent of Wrap On, 
if you use the SPL command. 
The SPL command sets up a 
job to SPooL data from one 
place to another. The command 
SPL “tHlename’ SCR will copy 
files to the screen. Because of 
the “non-destructive” windows of 
the Pointer Interface, the window 
will disappear when the whole 
file has been displayed. This is a 
nuisance if you don't press Ctri- 
F5 quickly enough to freeze the 
screen to stop this from 


happening. An alternative - SPZ 
‘tiename * #7 - will send the file 
to SuperBasic channel 1. You 
can view many files easily, if you 
use a combination of the 
SPL_USE and WCOPY 
commands. 


On a TV use: 


SPL_USE con_x200 
WCOPY fp? - 


On a Monitor use: 


SPL_USE con_512x206a0x0 
WCOPY fip?_ 


When more than one file is 
displayed, one after the other, 
the display can be messy. But 
the use of WCOPY allows wild- 
cards to be used and allows 
simple browsing of a disk or 
sub-directory. 

Note on SPL_USE: The effects 
of the SPL_USE command are 
permanent until a Reset or a 
SPL_USE/DEST_USE command 
is executed. Putting a SPL_USE 
command in your Boot file 
could save you time - you could 
view files with a simple WCOPY 
command. 


Copying files on your QL 

This is not the definitive guide 
to copying files but it will “get 
you started”, 

If you have two disk drives 
then it is very easy, just put the 
disk you want to copy from in 
drive two and the disk you want 
to copy to in drive one and type: 


WCOPY fip2_ TO fip1_ 


This Toolkit Two command 
will give you a filename and ask 
“Y/N/A/Q?" For example: 


flp2_Boot TO 
fio1_ Boot. Y/N/A/Q? 


The action the QL takes 
depends on your next key-press: 


Y ory - to copy the file, ask 
me about the following files 

Aor A - copy this file and ALL 
the files after it 

N orn - dont copy the file, ask 
me about the following files 

Qorgq - dont copy the file, 
don't ask me about any more 
files 


lf you don't have a double 


disk drive, and you have a 
tamdisk set up, follow these 


instructions: 


It you type LWA AAM7_ and 
you get the following two lines: 


RAM1 
200/400 sectors 


Then you have a ramdisk 
(ramdisks are standard with 
Trump Cards and Gold Cards 
and don't have to be formatted). 
The first number refers to the 
amount of free space left on the 
ram disk, in units of “half a KB" 
{the 200 shows that 100KB is 
free, this is approximately the 
amount of space on a 
microdrive cartridge). The 
second number refers to the 
total amount of space on the 
ramdisk (simply divide by two to 
get the capacity in KB - in this 
case 200KB). 

if you don't get the line "RAM1' 
followed by a sector count then 
your ramdisk may need to be 
FORMATted before it is used. 
This was necessary with the 
ramdisk on the Sandy 
SuperQboard. Enter the 
command FORMAT RAM1 _200. 
if you get “not found” or “out of 
memory" then please contact an 
experienced friend to help you 
further. 

With a ramdisk ready to go, 
put the disk you want to copy 
FROM and type WCOPY flp1_, 
ram1_. Copy the files you want 
into the ramdisk. Then put the 
disk you want to copy to into the 
disk drive and type WCOPY 
ram1_flot_. Press A to put a 
copy of every file present on the 
ramdisk onto the floppy disk. 
The files are still on the ramdisk, 
to get rid of them type WDEL 
ram _. It is a pity there is no 
WMOVE command. 


Creating a Boot disk for 
your QL. 


These instructions will help 
you set up a Boot disk for the 
first time and teach simple fault- 
finding. 

If you are using the Pointer 
Environment it is a good idea to 
have a single disk to boot from 
(but keep backup copies of it). 
This is because the Pointer 
Environment (ptr_gen, wman) 
and related files (hot_rext, 
menu_rext etc) have been 
improving over time. If you get a 
new Pointer program that has a 
newer version of ptr_gen in it 
put the newest version on your 
Boot disk. It is possible that your 
new Pointer program needs 
facilities that are only present in 


oe 


the newer files. 

Finding out the version of 
most Pointer Environment files is 
easy - all you have to do is View 
them {see “VIEWing files” 
appendix). 

The usual way to create a 
Boot file is to type “lines” into 
SuperBasic and then SAVE 
them. A “line” in SuperBasic is 
different from a “command” 
because it has a line number in 
front of it When a “line” is typed 
into SuperBasic, it stores that 
line in its memory. Type NEW to 
clear any old “lines” from 
SuperBasic's memory. Enter 
these lines into SuperBasic: 


5 REMark QPAC1 boot file 
10 TK2_EXT 

20 LRESPR FLP1_ptr_gen 
30 LRESPR FLP1_wman 
40 LRESPR FLP1_hot.rext 


Line 5 is a comment line, 
used to keep notes on the Boot 
program. Line 10 activates toolkit 
two. Lines 20 to 40 load the 
Pointer Environment (ptr_gen), 
the Window Manager (wman) 
and the Hotkey System Two 
(hot. rext), 


To show ail the “lines” that 
SuperBasic has in memory, type 
the command LIST. A group of 
SuperBasic “lines” is called a 
SuperBasic program and they 
may be stored on disk by the 
commands LOAD and SAVE. Try 
LISTing the lines you have typed 
in so far. If you have made a 
mistake then type the command 
EDIT followed by the number of 
the line you made the mistake 
in. 

The “lines” entered so far are 
instructions to load the Pointer 
Environment As we have 
Qpact, we would like to load 
those utilities as well. If we were 
using Qram, we would use the 
programs Boot_MAKE and 
HOT_MAKE. Being lucky Qpac 
users we get more flexibility and 
the thrills of typing in our own 
Boot programs. To complete the 
boot program, we need to add 
the commands for using the 
Qpac' utilities. 


50 REMark Load QPAC1 utilities 
60 ERT HOT_RES(A\, 

‘flp1 alarm’) 

65 ERT HOT_WAKE(a’, ‘alarm’ 
70 ERT HOT_RES(C’, 

‘{lp1 calculator) 

75 ERT HOT_WAKE(c’, 
‘calculator) 

80 ERT HOT_RES(K’, 


‘tipi _calendar) 

85 ERT HOT_WAKE(K, 
‘flp1 _calendar) 

90 ERT HOT_RES(D' 
‘1p1_clock) 

95 ERT HOT_WAKE(d,, ‘clock) 
100 ERT HOT_RES(M’, 
‘flp1_sysmon) 

105 ERT HOT_WAKE(m’, 
‘sysmon) 

110 ERT HOT_RES(W, 
‘lpi _typer) 

115 ERT HOT_WAKE(w’ 'typer) 
120 ERT HOT_PICK(b*”) 
130 ERT HOT_LOAD(S’ 
flp1_config’) 

140 HOT_GO 

150 HOT_Do ‘m' 

160 PAUSE 50 

170 HOT_Do 'b’ 

180 HOT_UST 


When you have typed all 
these “lines” in, put a blank, 
formatted disk in drive one and 
type SAVE FLP1_Boot The SAVE 
and LOAD commands must 
always be given a file name to 
tell SuperBasic which file it is to 
save/load. The Boot file we have 
saved may be read into 
SuperBasic again with the 
command LOAD FLP1_Boot 
When a file is LOADed, the 
previous SuperBasic program is 
removed from memory - it is 
NEWed. 

Note - If your QL says 
“FLP1_Boot exists, OK to 
overwrite.Y or N?" press N and 
use a disk that really is blank. 

When your disk drive light 
switches off, your QL will have 
finished saving the Boot file. 
Now we need to copy the other 
files onto your disk Following 
the instructions “Copying files” in 
the appendix, copy the files 
ptr.gen, wman, hot_rext, alarm, 
calculator, calendar, clock, 
sysmon, typer and config to the 
disk you saved our “boot' file to. 
When the disk drives have 
stopped whirring, press Reset 
and F1/F2 when the prompt 
appears. 


Simple fault finding in 
Boot programs 


Some resident programs insist 
on being loaded before others. 
The manual with Lightning 
(most editions) insists that it 
should be loaded before Toolkit 
Two is activated. By the time my 
QL gets around to looking for 
Lightning, Too/kit Two is already 
activated. Nothing happens so | 
seem to be getting away with it 

When loading the Pointer 


Environment the Pointer 
Interface “pir_gen” has to be 
loaded before “wman". You can 
load “hot_rext” whenever you 
want as far as ptr_gen and 
wman are concermed. 


When your QL stops in the 
middle of Booting and prints: 


5 REMark QPAC1 boot file 
10 TK2_EXT 

20 LRESPR FLP1_ptr_gen 

30 LRESPR FLP1_wman 

40 LRESPR FLP1_hot_rext 

50 REMark Load QPAC1 utilities 
60 ERT HOT_RES(A, 
‘flp1_alarm’) 

65 ERT HOT_WAKE(a’, ‘alarm’ 
70 programmer_UST 

At line 70;1 

bad name 


An error has occurred. The 
line number will vary and so will 
the message. (Note - Minerva 
error messages give a 
command number as well as a 
line number, a non-Minerva QL 
would have given the message 
“At line 70” instead of “At line 
70:1"). The first thing to do is to 
see the line that the QL has 
stopped at The command LIST 
70 will list the offending line, in 
our case: 


70 HIT_UST 


This is a spelling mistake - 
when writing the line, | was 
thinking of people who don't pay 
their invoices and so quite 
understandably typed “HITLIST” 
instead of “HOT_LIST”. Most “bad 
name” error Messages are 
caused by bad spelling of 
command names, 

Attempting to use toolkit 
commands before they have 
been loaded will also give a 
“bad name” error: 


20 LRESPR flp1_PTR_GEN 
30 LRESPR flp1_WMAN 

35 TK2_EXT 

38 HOT_LIST 

40 LRESPR fip1_HOT_REXT 


The above Boot program 
attempts to use a Toolkit Two 
command (LRESPR) before 
Toolkit Two is active {Line 35 
should be before line 20). It also 
tries a Hotkey command before 
Hotkey Two is loaded (Line 38 
should be after Line 40). 


10 TK2_EXT 
20 LRESPR flp1_PTR.GEN 
30 LRESPR fip1_WMAN 
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40 LHESPH tip1_HO1! REX! 
50 HOT_LIST 


Another common error is “not 
found" - this usually occurs 
when a file to be loaded isn't on 
the disk It could be that you 
have forgotten to put the file on 
the disk or you have given your 
QL the wrong filename. 


10 TK2_EXT 

20 LRESPR fip1_POINTER.GEN 
30 LRESPR 
flp1_WINDoW_MANAGER 

40 LRESPR fip1 HOTKEY_TWO 


The above program would be 
understood by a person but a 
computer likes a bit more 
precision. A QL would just give 
up with an error message. The 
QL-+riendly version of the above 
IS: 


10 TK2_EXT 

20 LRESPR fip1_PTR_GEN 
30 LRESPR fip1_WMAN 

40 LRESPR flp1_HOT_REXT 


When you are sorting out a 
Boot program, when an error 
occurs, you may want to tell the 
QL to carry on going, ignoring 
the current statement 


10 TK2_EXT 

20 LRESPR flp1 __PTR.GEN 
30 LRESPR flp1_WMAN 

38 HOT_LIST 

40 LRESPR flp1_HOT_REXT 


When the above Boot runs it 
will give an “At line 38;1 bad 
name" error message. LIST 
displays the whole Boot and we 
see that line 38 is a Hotkey 
command being used before 
the Hotkey Two is loaded. To tell 
the QL to skip this command 
and carry on running the Boot 
we type CONTINUE. The QL 
finishes the Boot 

To edit the Boot type ED. 
Move the cursor down to line 38 
and delete the 38 by pressing 
Ctrl-Right arrow, press 5 then 0 
to replace the 38 with 50 and 
press Down arrow. The screen 
should show: 


10 TK2_EXT 

20 LRESPR flpt PTR_GEN 
30 LRESPR flp1_WMAN 

38 HOT_LIST 

40 LRESPR flp1 HOT_REXT 
50 HOT. LIST 


Delete the unwanted line, 38, 
by moving the cursor over line 
38 and pressing Ctrl-Alt-Left 


arrow. Press ESCape to leave 
ED and save the new Boot 
program with the command 
SAVE flp1_Boot Your QL should 
ask “flpt_boot already exists, OK 
to overwrite.Y or N?”. Press Y 
and wait for the disk drive light 
to go out before removing the 
disk or resetting your QL Full 
instructions for the ED 
command are in the Toolkit Two 
manual {this may be found in 
the user guide of your 
expansion card, such as the 
SuperQboard manual, Trump 
Card manual, etc). 

Sometimes you will want to try 
a command in a boot program 
again. Consider the following 
‘Boot file being run on a disk 
with the files PTR_GEN and 
HOT_REXT on it 


10 TK2_EXT 

20 LRESPR fip1_PTR_GEN 
30 LRESPR flp1_WMAN 

40 LRESPR fip1_HOT_REXT 
50 HOT_LIST 


The Boot will stop with the 
error message “At line 30;1 Not 
found”. | would type DIR fip1_ to 
get the list of files present on the 
disk Hopefully | would realise 
that the file WMAN' isn't on the 
disk and put a disk that has 
‘WMAN' on it into drive two. and 
use the command COPY 
flp2_WMAN to flp1_WMAN. 
Then, with the problem fixed, | 
could type RETRY to tell the QL 
to try the line it stopped at (line 
30) and carry on. As the file 
‘WMAN’ has been copied, the 
boot will finish with no more 
errors. 


File lengths and RESPR 


When the QL first came out, 
the only way of loading toolkits 
was to allocate some resident 
procedure space (RESPR), ioad 
the toolkit into that space 
(LBYTES) and initialise it (CALL). 
This was inconvenient because 
when a new version of a toolkit 
was produced, all the boot 
programs had to be updated to 
accommodate the new size of 
the toolkit 

To load PTR_GEN 1.54 (file 
size 14534 bytes) using the old 
method: 


adoress=RESPA(1 4534) 


LBYTES tip1_PTR GEN, 
acgaress, CALL address 


The Toolkit Two equivalent is: 
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LRESPR flp1_P!| RLGEN 


It is only safe to replace the 
old method of RESPR-LBYTES- 
CALL with LRESPR if the code 
actually CALLs “address”. If, in 
the example above, | had to use 
CALL address+54, the LRESPR 
command would not be 
suitable. Fortunately most 
programmers make sure their 
toolkits can be LRESPRed. 


Coping with unexpected 
“freezes” 


This can be caused by some 
toolkits clashing or by replacing 
a CALL-LBYTES-RESPR 
sequence by an inappropriate 
LRESPR. 

Start tracking down the 
problem until you know exactly 
where in the Boot your QL is 
stopping/crashing. One way to 
do this is to insert lines into the 
program which display a 
message. For example, if 
‘WMAN' had become corrupted 
(without my knowledge) and this 
Boot program was crashing my 
QL for no apparent reason: 


10 TK2_EXT 

20 LRESPR fip1_PTR_GEN 
30 LRESPR fip1_WMAN 

40 LRESPR flp1_HOT_REXT 
50 HOT_LIST 


| would start putting PRINT 
lines in to indicate the QL's 
progress. 


10 TK2_EXT 

20 LRESPR fip1_PTR_GEN 

25 PRINT ‘ptr_gen loaded’ 

30 LRESPR fip1_WMAN : PRINT 
‘wman loaded’ 

40 LRESPR flp1 HOT_REXT - 
PRINT ‘hot_rext loaded’ 

50 HOT_LIST 


The above listing shows line 
25 has been added and that 
lines 30 and 40 have had extra 
commands added to the end of 
them. The commands are 
separated by a colon : and the 
only reason that they are on the 
same line is to give an example 
of this. Putting the PRINT 
commands on a new line or at 
the end of other lines does not 
affect the behaviour of this Boot 
program. 


Hotkeys 
The Hotkey System Two uses 


the Thing System to keep track 
of its resident programs. The 


Thing system is an extension to 
Qdos found in ‘hot_rext. It acts 
as a caretaker, keeping track of 
Things - where they are, what 
they are, who is using them, etc. 
QL users don't need to know 
much about them. QL 
programmers should use them 
more often. 


Hotkeys to make resident 
jobs 

When the Hotkey is defined, 
the program referred to will be 
loaded into memory and linked 
into the system as an 
executable thing. 

The HOT_RES, HOT_RES1 
functions will attempt to load the 
program into the resident 
procedure area (RESPR space) - 
if this is not possible (because 
some jobs are already running), 
it automatically loads the 
programs into the common 
heap. The HOT_CHP, 
HOT_CHP1 functions will load 
the program into the common 
heap.- 

If you weren't happy with the 
“Hotkey System 2” manual when 
you first looked at it go back to 
it look at the example boot 
programs (page 11) and refer to 
the table above. It may seem a 
bit clearer. 

ff that fails, have a look at the 
listing that accompanied my 
Qpac’! article, (QL World, March 
1991). The listing has some 
Hotkey definitions and the article 
gave some explanations. 


FILE SELECT -A 
SIMPLE GUIDE 


The File Select menu, written 
by Jochen Merz, is part of 
“menus” extension from the file 
“menu_rext’. 


Installing menu_rext 


When modifying your boot to 
load menu_rext, you will need to 
make sure hot_rext (the Thing & 
Hotkey system) is loaded before 
menu_rext This is because 
menu_rext links itself into Qdos 
using the Thing system. 

Have a look in your Boot file. If 
there is a command that loads 
hot_rext (usually LRESPR 
flp1_hot_rext) then place the 
command LRESPR 
flp1_menu_rext after that. If 
hot_rext isn't being loaded by 
your Boot file, change it so it 
does - menu_rext can't work 


without it 


— eee 


Page 
Hotkeys to type in text 


6 EES2 
7 EE33 


Hotkeys to load in jobs 
6 EE35 


HOT_KEY 
HOT_CMD 


HOT_LOAD 


A breakdown of the commands with Qpacl/Qpac2 (EE) page numbers. 


Type in text 


Hotkeys for executable Things 


5 EE38 


HOT_THING 


PICK SuperBasic & type in text 


Load & execute a job 
otherwise Load & execute it 


Function Action performed when hotkey is pressed 


Execute a thing (creates a job) 


otherwise execute a thing (creates a job) 


Hotkeys to make resident jobs 


2 BES4 


Using File_Select 


Move the pointer over the 
window - notice how items are 
highlighted as the pointer 
passes over them. This 
highlighting shows the user 
different options that they can 


Enquire about Hotkeys 


Page 
RE42 
EE42 
EE42 


Hotkey system commands 


6 EE39 
9 EE@4 


EE44 
EE41 
EE41 


trigger. 

The file select menu has three 
main areas - “file name’, “device 
name” and “file list’. 

The “file name" area, just 
below the title “Select File 
Name", will allow you to enter 
the file name in full. There are 
two other options - Current and 
Previous. This refers to the 
Hotkey buffer (Al-Space) which 
is set by some programs, 
usually to the name of a file 


© 


HOT_RES 


Name 
HOT_NAME$ 


HOT_DO 
HOT_STUFF 


HOT_GO 


being worked on. This “stuffing” 
of file names saves the user 
having to remember and type 
file names. 

The “device/directory name” 


area, at the bottom left of the “file 


area’, allows you to change the 
drive whose files are listed in the 
“file list". The current device can 


Type 


be changed to (MDV, FLP etc) 
and FILE_SELECT is intelligent It 
searches the system tables for 
device names so even if you 
added a laser disk to your QL 
{LAS1_? OPT1_? CD1_?), 
FILE_SELECT would be able to 
handle it The device/directory 
name may be Hit to edit it via 
the keyboard or it may be Done 
to pull down a Select Directory 
menu. Some of the facilities it 
offers are duplicated by 


Execute a job from memory 
otherwise-execute the thing (creates Job) 


FILE_SELECT - its unique 
options are “Data default" and a 
“commen directory list”. The 
“Data default" option reads the 
current Toolkit Two data default 
so that it can be edited or 
approved by “OK”. The 
“common directory list’ may be 
tailored to the individual users 


Action 

Function Return text linked with a key 
HOT_TYPEFunction Return a key's action type 

HOT_LIST Procedure List hotkey definitions 


HOT PICK Function Ctrl-C a named job to the top 

~ of the window pile 
Procedure Execute a hotkey from a 
program 

Procedure Place text in the stuffer buffer 
HOT_STOPProcedure Stop the ‘HOTKEY' job 


Procedure Start the 'HOTKEY' Job 


needs by using config on 
menu_rext 

The “file list” area, at the 
bottom right of the “file area’, is a 
menu of file names. Doing a file 
name quits the ALE_SELECT 
menu and marks that file name 
as "chosen". Hitting that filename 
puts it in the file name buffer 
where it can be edited or 
chosen by Hitting/Doing “OK”. 
The “file list" has some controls 
to make life easier. 


The “EX!” control will allow the 
user to set a file extension so 
that only files ending with a 
particular file extension will be 
listed. Hitting EXT (cr pressing E) 
will allow keyboard entry of a 
new file extension. Doing EXT 
will pull down a menu of 
common file extensions. This 
menu of file extensions may be 
tailored to the individual users 
needs by using config on 
menu_rext 

The ‘View’ control, a recent 
improvement to File Select, is 
normally switched off. When 
View is switched on (by Hitting it) 
then the handling of the file 
menu is subtly changed. Doing 
a file in the file menu will still 
chose that particular file, But 
Hitting a file will now ask your 
QL to display the file. The View 
screen has a few simple 
commands - ESCape (Quit 
viewing), Wake (go to star) and 
Wrap. Wrap is usually switched 
off. With Wrap switched off, only 
the first part of long text lines will 
be displayed. With WRAP 
switched on, long lines will wrap 
around onto the next display 
line. It is best to view Quill 
documents, program files, any 
binary data with Wrap switched 
on. 

The Directory Up and Tree 
controls deal with “level-2 device 
drivers" where “hard sub- 
directories” are being used - 
mainly of interest to Atari QL or 
Gold Card QL users. The Tree 
control, when switched on, will 
look for directories below the 
current directory (sub-directories). 
Then the names of files found in 
these sub-directories will be 
placed in the file menu. 
Switching Tree off will cause all 
the files from sub-directories to 
be removed from the file list The 
Directory Up control is only of 
use in a sub-directory, It tells the 
file menu to get its file names 
from the “parent” directory of the 
current directory. 


Sources of QL 
Expansion/related items 


Miracle Systems Lto 
25 Broughton Way 
Osbaldwick 

York YOT 3BG 
0904 423986 


Gold Card system expansion 
£225: all Trump Card facilities or 
better, 1920KB memory, QL 5x 
faster, plus DEV device, Hard 
sub-directories 
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ual ED disk drives £1/5, Can Dilwyn Jones Computing easily. Main dealer for many 
handle 720KB DD, 1.44MB HD Various types of Lversa/ 41 Bro Emtys German programs - English 
and 3200KB ED 35in disks. disk dnves (suitable for use on Ta/-y-Bont manuals provided, and English 
Intended mainly for Gold Card many computers). £25-£130. Bangor versions of German programs. 
QL seral mouse (three Gwynedd LL57 3YT Can accept 
Qubbesortt PD buttons) £45. In this almost 0248 354023 UK cheques. 
38 Brinwin Road complete package you get Also sells 
Braintree some driver software {a file Main UK dealer for Q/ump some QL 
Essex CM7 5BU called E_SERMOUSE),a mouse, = software: hardware and 
O376 347852 a cable, instructions and a Qpac? £19.95, Qpac2 £29.50 QL emulators 
mouse mat The only missing Other pointer programs sold for the Atari pe. 
Trump Card £95.00 plus p&p. component is a copy of include Disa Disassembier ST. See 
768KB memory for a total of PTR_GEN. PTR_GEN is included {intelligent machine code tool) adverts in QL 
896KB, Toolkit Two, screen with all commercial Pointer £29.00 and Data Design World. Recent 
dump, printer buffer, dynamic programs these days. (database) £50 releases Li 
ram disk, disk interface. Mouse suitable for QIM! £70 include: 
Expanderam 512K, £45 plus See adverts in QL World. EasyPi 3 -a Sede 
p&p. Expands QL's memory to Quanta Pointer 
512+128 giving 640KB. The C/o Bil Newel! Pointer Products program 
drawback is that another 213 Manor Rd. 68 King Down Rd development 
interface is needed if disk drives Benfleet Blandford tool. The new a 
are to be used. Essex SS7 4/D Dorset D717 8BN version 
Dual 720KB 3.5-in Oisk Sells many different Pointer provides = 
onves, £100 plus p&p. QIM/ mouse interface £27 Programs support for C 
Motorola 68000 reference £6 0258 455117 programmers. 
See their regular adverts in QL Definitive Guide to QSpread - eo 
World for more details. SuperBasic by Jan Jones £10 Jochen Merz Software spread sheet 6. 
Membership to Quanta is by /m Stillen Winkel 12 This has been 
EEC (W N Richardson & Co) annual subscription. D-4100 Duisberg 77 revised and 
18-21 Misbourne House Germany has a new ae 
Chiltern Hill Various second hand QL 0203 591 706 manual. 
Chalfont St Peter systems - Caveat emptor and A bulletin board “Qdos- QUME QL- = 
SLO QUE vendor! Mailbox" service is planned to emulator for 
0753 888866 allow registered users to update = He Afa’ STE. 
reorsseeraa (EEC) ~~ A.A. Richardson & Co. 


SINCLAIR QL PRICE LIST 
JANUARY ‘93 


18-21, Misbourne House, 
Chikern Hit 
Chaifont St. Petar, SLS SUE 


All Prices Include 17.5% VAT 


[Q Computers} NEW-MONITOR £50 CHEAPER 


JS COMPLETE daesporpiinspen Se Computer, PSU, Felon Sotcwume ¢ Archive, Abacus & Pasei) £120.00 
to QUANTA, the independant QL User Group with over 400 

peadeaslganelnger reer WITH IM ROM £100.00 

PART EXCHANGE A exchange allowance of £30 is available, JS £90 IM £70.00 


IM BACKUP Tnchades QL Compater and PSU caly £75.00 


aa 


WITH ISROM £85.00 


NOTE: EXTERNAL (SER2) § BUTTON MOUSE AND SOFTWARE 
WITH EXTRA FUNCTIONS. 


NOW HERMES COMPATIBLE. 


KEYBOARD INTERFACE, INTERNAL FITTING, POR FITTING 102 KEY KEYBOARD 
PS ERYBOARD, UE wnt 0d by (AT cen £3000 
CASE and LEAD for EXTERNAL FITTING of Keyboasd Entectace = £1400 


JOYSTICK with QL lead (no interlace required) 


Disk Drives 


Universal 3.5" 2Mb disk drive, as above but 2Mb 
3.57 IM Uncased dlak deve (CIXIZEN) 


* QL MOUSE, 3 Button, Saftwase commolled, extemally mounted, simply fits in SER2 £45  REMOTEMOUSE £55.00 


THE UNIVERSAL DRIVES ARB ALSO SUITABLE FOR ACORN BBC, ATARI ST, 
AMIGA, SPECTRUMS, IBM. AMSTRAD AND OTHER YO COMPATEN ES 


‘Universal 3.5" 1Mb disk drive, cased with PSU and free QL bead 
capacity 


£70.00 
£90.00 


2 Unita for dual drive 
2 Units for dual drive 


disk drive 
Lead for uncased disk drives, or other universal micros £10.00 POWER SUPPLY POR UNCASED DRIVES £ 6.00 


NEW RANGE 


MBTAL CASES FOR UNCASED DRIVES €£ 6.00 


eee te, 50 LG. 3K Print Buffer, Centronics, Tractor Feed/Shest Pak £149.00 
OLIVETII COLOUR 
COLE 200 coe, $0 NLQ. 40K Bulla, Expon LORS Compute, £239.00 
QL LEAD POR SERIAL = 
i PHILIPS 14" HIGH RES COLOUR EGA .31 DOT PITCH, FULL 85 COL 
WITH AMBER OR GREEN TEXT FEATURE, IDEAL FOR WORD 
PROCESSING, RECONDITIONED, 90 DAY WARRANTY. 
OK FOR PC AND QL SELF SENSING AND MANY EXT/L CONTROLS. 
Microdrive Cartridges and Spares 
4 New Cartridges in a wallet 10.00 3 for reformatting in 2 wallets £13.00 
ays arn 7 
QL Psion Software  Separis £10.00 
Unit 21000 
ye Necwott lade £300 ‘Top & botom Cae = 300 
Ice Txt £600 KRM 3.00 wae ® C300 cist £ 3.00 
QL SERVICE MANUALS & CIRCUIT sso S.A.E, FOR FURTHER DETAILS 


—= Fee Carriage - £9 


Os, 2 saiie mee. 


Postage - £3 
Overseas - Add £10 for dalivery 


SD TEL: 07 0753 888 888866 FAX: 0753 887149 


MINERVA 


The BLIINATE operating systen upgrade 
MIT MINER nou urth battery fer 26 bytes 
irom, CRASHPROOF clock & interfoce (1?) for 
robots etc. Can avtoboot from battery ran, 
Uther Features {common to MKIAKID! 
Autotoot on reset’ Mutteple Basic’ Faster 
schedzler-graphics 18% of Lightning?=string 
hand! ng etc’ UHEN ERROR/ Second screen/TRACE 
Fore.gn kybd drivers’ ‘Warm’ fast reset etc 


NEE o MET UPGRAOES r up to 1.79-£5. Rest FREE 
Gsend rom PROTECT LEGS!) ond disk or 2 mdvs) 
[original NKI £40 MELT 

ALL VERSTONS FULLY GOLD CARD COMPATIBLE 


OBES - The first UK GL scrolling bulletin 
board. Now ever: larger uith internations! 
ECHOnat | and i0nb of Files <inctuding 
the WHOLE King Jowes' bible!) 


ual sort 


ViewdataVES2-01100 OL TERMINAL EMULATOR 
Multitasking for etectronic mail, PRESTEL elc, 
CET dountoad. Coapatible vith Tandata Geonnect 
GL moden/nodaptor. Use Gcormect RS2320 bo drive 
unbuffered modems. Comprehensive AS sanual, 


Software (3,5" or andy) & manual £30 
FILE TRANSFER - to transfer text AND programs 
error free COQCEH belueen coapulers 


vas lable for 18H compats , ATARI ST & Sinctoir & 
Connects to Psion range vith RS232C comms (ink 
Softuore £7,50 per mc. Cable £14 (name 2 m/cs) 


Rll prices include UAT and postage in the LK 


HERMES 


Do you get keyboard bounce? 
Bo you Find Fast serial input unreliable? 
Do you want to run ao MST 14480 bps noden? 


If you can say YES to any one of these, then 
this is a product gou have been waiting For 


+ Gives up to 19268 bps RELIABLE serial input 

+ Independant baud rates 

+Stops keyboard ‘bounce’ (unuanted repeat ches) 
+ Tmproves ‘fuzzy’ and ‘random’ sound 

+ Provides extra inpul and output lines 

+¥ey click 

+ ReseteINT? invoked wore safely 


FITTING is @ simpta job. Simply remove the 
@ top {8 screws) and reploce the chip marked 
“849° raxt to wicrodrive 1. 


PRICE (including mrwal % softuare) £25 
ae SPARES 


Faulty & boards (exc! plug in Ifs)..... 
+ EB Circuit di 
Hy 1377 PAL. 


QL REPAIRS 


Qls tested vith Thorn EN] test rig 


and ROM sofluare 
CHOY harduare extra if required) 


E27 =- 6&6 month guarantee 


NAIL ORDER ONLY 


12 Bouverie Place, London U2 {RB (tel: 071-724 9053) 


SCROLLING BBS FOR ORDERING/QL HELP ond FAY = 871-706 2379 


Dilwyn Jones Computing 


41 Bro Emrys, Tal-y-Bont, 
Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


E 
oF CODPS I 


THE MEANING 


{SOME of GUF png 
et is relunc: 


FILE TRANSFER 
DISCOVER 
Febek] Copy ‘les ODOS :o PS disks ard vice vewa 
MU DISCOVER 
[F 266k Enhance versions, ela formals 
TEXTIDY 
[PM 255K Sb Guill lay ate c 
OPD INTERCHANGE 


LEISURE 

M1284) 4 vary acd.clye saliearos cad game 
CRICKET SECRETARY 
[FRY 28k For sockel bulls evgnyariargl 
QUESTION MASTER 
[M1 28k] “or revision or emerair-ient 
QUIZ SETS each 
FLEET TACTICAL i est Wat 
F S124! aval 3 
ce TACTICAL COMMAND Ml PC 

PO] -osneed PC vers-or of is supern game 
COMBINED OL & PC VERSIONS 
Peck ae for vols QL aval PO versons cogeher 
FTC2 DATA PRINT UTILITY 
(128k) Orval cul cata from FIC: ceseribed above, 
THE FUGITIVE 
~ 12k] [set acyartur 


COCKTAILS WAITER ; 1005 


ereks cites 


TEE BUS 


PROGRAMMING 
S EDIT editor 
[F 284k] DEM Wo 
EASYPTA Ml 


F 258k! Pointer ewinairel programming ad. 


THE SMALL IT! POSTAG 
ageapl caymenl % cnegque lin UK 
Raps Sta PE card bye MUTIDEL, 2 


PAGS 


EASYPTR Ht BUDGET VERSION 

DISA DISASSEMBLER 

F 256k] Interactive painter drven disassemble, 
BASIC REPORTER S100 
(FM 128] BASIC oregramming aud, list variables, '0. 
BUDGET QLIBERATOR COMPILER 

FM i ASIC compiler for unexpandes © 
QUIBERATOR BASIC COMPILER £5030 
|F 288k, Excellent BASIC compiler ‘or the OL 

QLOAD & QREF UTILITY M1508 
[FM 128k 128k Fast loader and cross refererce: utility 

MEGA TOOLKIT on disk 

on EOROM cartridge and disk 

Currprehensve todlt of over 200 S456 extensions 


P2500 


FILE HANDLING 
LOCKSMITHE 


NW 128k] Mcredrive backup proaram. ovte for aye 
4MATTER & LOCKSMITHE 

FM 384k] Conplete saftware beckup sysrem 
TOOLCHEST 
Mr rpate Customised micvave doctor 
[FM 128« Sinple fo use popup file handling wt 
FILEMASTER 

[F MS12k R] For bulk coey sg of fas, & dk label ne, 
THE GOPHER 


DISPLAY SOFTWARE 

eicidie 

12k] Benner printing preararr for es: “ta 
Wsion MIXER 1 

o12k| Scraer cigala 

VISION MIXER PLUS 
F S844 Ennanoad, neru driven version 
PICTUREMASTER 
F 288« Screen drawing utility fi 
PICTUREMASTER PLUS 
F384 Enranced version, axa teat.ras, 


UPGRADE TO “PM PLUS” 


or use with VMixer, 


PRINTER DUMPS 
SIDEWINDER PLUS 
[FI an ane DIF pag 

and 24 pen oristers 


2 onirler Gung all by 


GRAPHICS 

THE PAINTER V4.04 
FS12« 100% micoce pele driven graaP os pea 
THE piel 
(T 18k) 3 disks peckes tll o° screen sict.ras, 
PICTORIAL INDEX FOR THE CLIPART 
New aricted index ie: ne Dligarl, with sor 
QRACTAL 

12k] Machirs eons taccals pregrarr 
QRACTAL SCREENS 
| 125k] Semple scveer potures Trace with Gractsl, 
IMAGE PROCESSOR 2 


ture aciting, ate atiley. 


BOP CUT ES. 


PD2 CLIPART 

F 1284 ¢ cis«s of clipart sereens 
SCREEN SNATCHER 

[FRA 128< Grab scrse other program, 
TEXT W ith 


eT dL 198 


ransale 9 si araphics “er 24 pir primes, 
SCREEN COMPRESSION 


FM 128k SIEW! Save space oy comorassing pisuras 
TEXT 
QTYP 2 


F 512k| Speling checker, uses pombe environment, 
BIBLE TEXT DISKS, PLAIN TEXT FORMAT 
BIBLE TEXT ae QUILL FILE FORMAT 

F 312k) Teat af the King James Bible cn disks, 
SPELLBOUND 

FM 38dk' Spelling checker, non-poimer anvirarimer iL 
SPELLBOUND SPECIAL EDITION 

F 512k] Improved version with larger distionary. ate 
UPGRADE TO SPECIAL EDITION 

Pease return master disk’cartridge when upgrie °q. 
QUICK POSTERS 

F A 128k" Text poste maker for ose wile 


DATABASES 
ADDRESS BOOK & LABEL PRINTER, 


arabase + label prister 


Star priv iens, 


FLA HBACK. SPECIAL EDITION 

=nharcec version of Alashoack 

QL GENEALOGIST SECOND EDITION 

F 3844] Family trees and family history praarr. 
UPGRADE TO SECOND EDITION 

Please ralurri master disk wit upgrace order 
BUDGET 128K GENEALOGIST 

“M128 Cut cow’ version lar unexparsed manniras 
DISK INDEXER 

FM 256k) Make a dalabase of contents of your disks 
DBEASY 

F 512] Catabase fon ene fe 


DBPROGS 


* Archive als 


actos of Arch ve ulilties ana tax: Wes 


QL HARDWARE 
MINI PROCESS CONTROLLER 
olay switched oumpurs, cortralled via OL sera parts, 
ARE TOOLKIT FOR MPC 
26K) Exte a simpuily coniral the: MPC 
NETWORK PROVER 
Asrral box wnicr: plugs 


QPOWER REGULATOR 


fen aetworked “is 


OTHER QL SOFTWARE 
QPAC{ 
FB 1] Famer orvircamer: vvililies, 
QPAC2 
Fa 2k) Fes ma venarce ment bots, oe 
QTOP 
= 256k) Cases oysters files, 
PRINTERMASTER 
FM * 28k) Sinker exsrtsd utblisy 
HOME BUDGET 
FM 128k] Comostic bills ard eccouns gragrar’: 
REMIND-ME 
“Mi 1254 Dates romincar uragrar Ver 
REMIND-ME PLUS 
FM ° 28k) Sahanees version * 
SCREEN ECONOMISER 
FMM | 28k) Screen saver barkor, 
SCREEN 
=H BBall. hex ie 


ch acre, se 


wHhera: Nites ees 7 


SLOWGOLD 
F 125k) Soewhven rculine fer 
TASKMASTER 
IFA SHAK Task sai 


OP rig) Lal by. 


(otk ints rea: abels lor yo. faces dake 
THE CAT 

fF Mt 125¢] List Fenames a celumins 

ROB ROY BARGAIN PACK 


[FM 128k Reviewer ir G_ Works cana 1991 


ceil card oer re Serer Th 


fey ral LEASE STAGT F YOU REQURE SCHTHMRE O25 


PaO 


4002 


ies 


